@mastra/factory 0.15.0 → 0.16.0-alpha.10

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

@@ -1,32 +1,370 @@
-import { platformApiClientConfigFromEnv } from "../api-client.js";
-import { IncidentioApiClient } from "../../incidentio/api.js";
-import { createIncidentioIntake } from "../../incidentio/intake.js";
+import { PlatformApiClient, platformApiClientConfigFromEnv } from "../api-client.js";
+import { IncidentioApiClient, IncidentioApiError } from "../../incidentio/api.js";
+import { buildIncidentioRoutes } from "../../incidentio/routes.js";
+import { buildIncidentioAgentTools } from "../../incidentio/agent-tools.js";
+import { resolveIncidentioRules } from "../../incidentio/default-rules.js";
+import { INCIDENTIO_FOLLOW_UPS_SOURCE_ID, INCIDENTIO_INCIDENTS_SOURCE_ID, createIncidentioIntake } from "../../incidentio/intake.js";
+import { attachIncidentioRules } from "../../incidentio/rules.js";
 import { attachIncidentioIssueReconciler } from "../../incidentio/issue-reconciler.js";
 import { incidentioReconciliationEnabled, incidentioReconciliationInterval } from "../../incidentio/reconciliation-config.js";
 import { IssueReconcileWorker } from "../../issue-reconcile-worker.js";
 //#region src/integrations/platform/incidentio/integration.ts
+/**
+* Provider config key registered for incident.io in Mastra Platform's
+* integrations catalog. Connections are discovered at runtime — no
+* deploy-time connection ID wiring.
+*/
+const PLATFORM_INCIDENTIO_PROVIDER_CONFIG_KEY = "incident-io";
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const CONNECTION_TOKEN_PREFIX = "incidentio-connection:";
+const SCOPED_SOURCE_PREFIX = "incidentio-source:";
+const BASE_SOURCE_IDS = [INCIDENTIO_INCIDENTS_SOURCE_ID, INCIDENTIO_FOLLOW_UPS_SOURCE_ID];
+function encodeScopedSourceId(connectionId, sourceId) {
+	return `${SCOPED_SOURCE_PREFIX}${Buffer.from(JSON.stringify({
+		connectionId,
+		sourceId
+	})).toString("base64url")}`;
+}
+function decodeScopedSourceId(value) {
+	if (!value.startsWith(SCOPED_SOURCE_PREFIX)) return null;
+	try {
+		const parsed = JSON.parse(Buffer.from(value.slice(18), "base64url").toString("utf8"));
+		return typeof parsed.connectionId === "string" && typeof parsed.sourceId === "string" ? {
+			connectionId: parsed.connectionId,
+			sourceId: parsed.sourceId
+		} : null;
+	} catch {
+		return null;
+	}
+}
+function incidentioConnection(connectionId) {
+	return {
+		type: "oauth",
+		accessToken: `${CONNECTION_TOKEN_PREFIX}${connectionId}`
+	};
+}
+function connectionIdFromConnection(connection) {
+	if (connection.type !== "oauth" || !connection.accessToken.startsWith(CONNECTION_TOKEN_PREFIX)) return null;
+	return connection.accessToken.slice(22) || null;
+}
+/**
+* Base (per-connection) source ids selected for a connection. Scoped ids
+* select their own connection; legacy unscoped ids (`incidentio:incidents`)
+* from pre-discovery deploys apply to every connection.
+*/
+function baseSourceIdsFor(connectionId, sourceIds) {
+	const selected = /* @__PURE__ */ new Set();
+	for (const sourceId of sourceIds) {
+		const scoped = decodeScopedSourceId(sourceId);
+		if (scoped) {
+			if (scoped.connectionId === connectionId) selected.add(scoped.sourceId);
+			continue;
+		}
+		if (BASE_SOURCE_IDS.includes(sourceId)) selected.add(sourceId);
+	}
+	return [...selected];
+}
+function encodePageCursor(cursor) {
+	return Buffer.from(JSON.stringify(cursor)).toString("base64url");
+}
+function decodePageCursor(cursor) {
+	if (!cursor) return null;
+	try {
+		const parsed = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+		if (typeof parsed.connectionId !== "string" || !parsed.connectionId) return null;
+		return {
+			connectionId: parsed.connectionId,
+			...typeof parsed.inner === "string" && parsed.inner ? { inner: parsed.inner } : {}
+		};
+	} catch {
+		return null;
+	}
+}
 var PlatformIncidentioIntegration = class {
 	id = "incidentio";
-	intake;
+	#clientConfig;
+	#platformClient;
 	#endpointHost;
+	#intakeByConnectionId = /* @__PURE__ */ new Map();
+	#rules;
+	/** Bound once by the factory via `initialize()` before any surface is used. */
+	#projects;
+	#auth;
+	#intakeStorage;
+	#orgIdByResourceId = /* @__PURE__ */ new Map();
 	constructor(config = {}) {
-		const connectionId = config.connectionId?.trim() || process.env.MASTRA_INCIDENT_IO_CONNECTION_ID?.trim();
-		if (!connectionId) throw new Error("PlatformIncidentioIntegration: missing required MASTRA_INCIDENT_IO_CONNECTION_ID.");
-		const clientConfig = config.clientConfig ?? platformApiClientConfigFromEnv();
-		this.#endpointHost = new URL(clientConfig.baseUrl).host;
-		const proxyBaseUrl = `${clientConfig.baseUrl.replace(/\/+$/, "")}/v2/connections/${encodeURIComponent(connectionId)}/proxy`;
-		this.intake = createIncidentioIntake({
+		this.#clientConfig = config.clientConfig ?? platformApiClientConfigFromEnv();
+		this.#platformClient = new PlatformApiClient(this.#clientConfig);
+		this.#endpointHost = new URL(this.#clientConfig.baseUrl).host;
+		this.#rules = resolveIncidentioRules(config.rules);
+	}
+	/** Event rules driving automatic follow-up materialization and close handling. */
+	get rules() {
+		return this.#rules;
+	}
+	initialize({ projects, auth, intake }) {
+		this.#projects = projects;
+		this.#auth = auth;
+		this.#intakeStorage = intake;
+	}
+	/** Cross-integration intake selection/binding domain — agent-tool authorization. */
+	get intakeStorage() {
+		if (!this.#intakeStorage) throw new Error("PlatformIncidentioIntegration is not initialized — the factory binds storage during prepare().");
+		return this.#intakeStorage;
+	}
+	/** Factory projects domain — maps a session's resourceId to its owning org. */
+	get projects() {
+		if (!this.#projects) throw new Error("PlatformIncidentioIntegration is not initialized — the factory binds storage during prepare().");
+		return this.#projects;
+	}
+	/** Whether the host runs with web auth enabled; every surface is inert without it. */
+	get authEnabled() {
+		return this.#auth?.enabled() ?? false;
+	}
+	/**
+	* Map a session's resourceId (the factory project id) to its owning org.
+	* Same caching semantics as the Jira integration: definitive misses are
+	* cached, transient database failures are not.
+	*/
+	async resolveOrgId(resourceId) {
+		const cached = this.#orgIdByResourceId.get(resourceId);
+		if (cached !== void 0) return cached;
+		if (!UUID_RE.test(resourceId)) {
+			this.#orgIdByResourceId.set(resourceId, null);
+			return null;
+		}
+		let orgId;
+		try {
+			await this.projects.ensureReady();
+			orgId = (await this.projects.getById({ id: resourceId }))?.orgId ?? null;
+		} catch {
+			return null;
+		}
+		this.#orgIdByResourceId.set(resourceId, orgId);
+		return orgId;
+	}
+	/**
+	* Org-scoped agent tools: the read-only follow-up detail tool for sessions
+	* whose resource is a factory project with an active Platform-managed
+	* incident.io connection.
+	*/
+	async agentTools(args) {
+		if (!await this.hasActiveConnections()) return {};
+		return buildIncidentioAgentTools({
+			requestContext: args.requestContext,
+			incidentio: this
+		});
+	}
+	async listConnections() {
+		const providerKey = encodeURIComponent(PLATFORM_INCIDENTIO_PROVIDER_CONFIG_KEY);
+		return (await this.#platformClient.request("GET", `/v2/connections?providerKey=${providerKey}`)).connections;
+	}
+	async hasActiveConnections() {
+		return (await this.#activeConnections()).length > 0;
+	}
+	clearCaches() {
+		this.#intakeByConnectionId.clear();
+		this.#orgIdByResourceId.clear();
+	}
+	async #activeConnections() {
+		return (await this.listConnections()).filter((connection) => connection.status === "active").slice().sort((left, right) => left.id.localeCompare(right.id));
+	}
+	#connectionIntake(connectionId) {
+		const cached = this.#intakeByConnectionId.get(connectionId);
+		if (cached) return cached;
+		const intake = createIncidentioIntake({
 			api: new IncidentioApiClient({
-				baseUrl: proxyBaseUrl,
-				accessToken: clientConfig.accessToken,
-				...clientConfig.fetchImpl ? { fetchImpl: clientConfig.fetchImpl } : {}
+				baseUrl: `${this.#clientConfig.baseUrl.replace(/\/+$/, "")}/v2/connections/${encodeURIComponent(connectionId)}/proxy`,
+				accessToken: this.#clientConfig.accessToken,
+				...this.#clientConfig.fetchImpl ? { fetchImpl: this.#clientConfig.fetchImpl } : {}
 			}),
-			connection: {
-				type: "oauth",
-				accessToken: `${CONNECTION_TOKEN_PREFIX}${connectionId}`
-			}
+			connection: incidentioConnection(connectionId)
 		});
+		this.#intakeByConnectionId.set(connectionId, intake);
+		return intake;
+	}
+	async #connectionContexts() {
+		return (await this.#activeConnections()).map((connection) => ({
+			connection,
+			intake: this.#connectionIntake(connection.id)
+		}));
+	}
+	/**
+	* Resolve the intake for an explicit connection token, or fall back to the
+	* sole active connection so legacy single-connection callers keep working.
+	*
+	* A caller-supplied connection token is only a claim: the id it carries
+	* must match a connection the deployment actually discovered as active
+	* before any proxy request is minted with the Platform credential.
+	*/
+	async #intakeForConnection(connection) {
+		const connectionId = connectionIdFromConnection(connection);
+		const active = await this.#activeConnections();
+		if (connectionId) {
+			if (!active.some((candidate) => candidate.id === connectionId)) throw new IncidentioApiError("incident.io connection is unavailable or requires reauthentication.", 401);
+			return {
+				intake: this.#connectionIntake(connectionId),
+				connection: incidentioConnection(connectionId)
+			};
+		}
+		if (active.length === 1) {
+			const soleId = active[0].id;
+			return {
+				intake: this.#connectionIntake(soleId),
+				connection: incidentioConnection(soleId)
+			};
+		}
+		throw new IncidentioApiError(active.length === 0 ? "incident.io connection is unavailable or requires reauthentication." : "incident.io request must identify a connection when multiple accounts are connected.", active.length === 0 ? 401 : 400);
+	}
+	intake = {
+		resolveIntakeDispatch: (input) => this.#resolveIntakeDispatch(input),
+		listSources: () => this.#listSources(),
+		listItems: (input) => this.#listItems(input),
+		listIssues: (input) => this.#listIssues(input),
+		getIssue: (input) => this.#getIssue(input),
+		createComment: (input) => this.#createComment(input),
+		updateIssue: (input) => this.#updateIssue(input)
+	};
+	async #resolveIntakeDispatch(input) {
+		if (input.externalSource.type !== "issue") return null;
+		const externalId = input.externalSource.externalId;
+		const contexts = await this.#connectionContexts();
+		if (contexts.length === 0) return null;
+		if (contexts.length === 1) {
+			const resolved = await contexts[0].intake.resolveIntakeDispatch?.(input);
+			return resolved ? this.#scopeResolvedDispatch(contexts[0].connection.id, resolved) : null;
+		}
+		let firstError;
+		for (const context of contexts) try {
+			if (!await context.intake.getIssue({
+				connection: incidentioConnection(context.connection.id),
+				issueId: externalId
+			})) continue;
+			const resolved = await context.intake.resolveIntakeDispatch?.(input);
+			return resolved ? this.#scopeResolvedDispatch(context.connection.id, resolved) : null;
+		} catch (error) {
+			if (error instanceof IncidentioApiError && error.status === 404) continue;
+			firstError ??= error;
+		}
+		if (firstError !== void 0) throw firstError;
+		return null;
+	}
+	#scopeResolvedDispatch(connectionId, resolved) {
+		return {
+			...resolved,
+			connection: incidentioConnection(connectionId),
+			...resolved.sourceId ? { sourceId: encodeScopedSourceId(connectionId, resolved.sourceId) } : {}
+		};
+	}
+	async #listSources() {
+		const contexts = await this.#connectionContexts();
+		const sources = [];
+		for (const context of contexts) {
+			const account = context.connection.accountLabel;
+			const inner = await context.intake.listSources({
+				orgId: "",
+				userId: ""
+			});
+			for (const source of inner) sources.push({
+				...source,
+				id: encodeScopedSourceId(context.connection.id, source.id),
+				name: contexts.length > 1 && account ? `${source.name} (${account})` : source.name,
+				metadata: {
+					...source.metadata ?? {},
+					connectionId: context.connection.id,
+					...account ? { account } : {}
+				}
+			});
+		}
+		return sources;
+	}
+	async #listItems(input) {
+		if (input.sourceIds.length === 0) return {
+			items: [],
+			nextCursor: null
+		};
+		const contexts = await this.#connectionContexts();
+		const cursor = decodePageCursor(input.cursor);
+		let startIndex = 0;
+		let exactMatch = false;
+		if (cursor) {
+			const index = contexts.findIndex((context) => context.connection.id === cursor.connectionId);
+			exactMatch = index !== -1;
+			startIndex = exactMatch ? index : contexts.findIndex((context) => context.connection.id.localeCompare(cursor.connectionId) > 0);
+			if (startIndex === -1) return {
+				items: [],
+				nextCursor: null
+			};
+		}
+		for (let index = startIndex; index < contexts.length; index++) {
+			const context = contexts[index];
+			const baseSourceIds = baseSourceIdsFor(context.connection.id, input.sourceIds);
+			if (baseSourceIds.length === 0) continue;
+			const page = await context.intake.listItems({
+				orgId: input.orgId,
+				userId: input.userId,
+				sourceIds: baseSourceIds,
+				...index === startIndex && exactMatch && cursor?.inner ? { cursor: cursor.inner } : {}
+			});
+			const nextCursor = page.nextCursor ? encodePageCursor({
+				connectionId: context.connection.id,
+				inner: page.nextCursor
+			}) : index + 1 < contexts.length ? encodePageCursor({ connectionId: contexts[index + 1].connection.id }) : null;
+			return {
+				items: page.items.map((item) => ({
+					...item,
+					sourceId: encodeScopedSourceId(context.connection.id, item.sourceId),
+					metadata: {
+						...item.metadata ?? {},
+						connectionId: context.connection.id
+					}
+				})),
+				nextCursor
+			};
+		}
+		return {
+			items: [],
+			nextCursor: null
+		};
+	}
+	async #listIssues(input) {
+		const resolved = await this.#intakeForConnection(input.connection);
+		const connectionId = connectionIdFromConnection(resolved.connection);
+		const baseSourceIds = connectionId ? baseSourceIdsFor(connectionId, input.sourceIds) : input.sourceIds.map((sourceId) => decodeScopedSourceId(sourceId)?.sourceId ?? sourceId);
+		return resolved.intake.listIssues({
+			...input,
+			connection: resolved.connection,
+			sourceIds: baseSourceIds
+		});
+	}
+	async #getIssue(input) {
+		const resolved = await this.#intakeForConnection(input.connection);
+		return resolved.intake.getIssue({
+			...this.#withBaseSource(input),
+			connection: resolved.connection
+		});
+	}
+	async #createComment(input) {
+		const resolved = await this.#intakeForConnection(input.connection);
+		return resolved.intake.createComment({
+			...this.#withBaseSource(input),
+			connection: resolved.connection
+		});
+	}
+	async #updateIssue(input) {
+		const resolved = await this.#intakeForConnection(input.connection);
+		return resolved.intake.updateIssue({
+			...this.#withBaseSource(input),
+			connection: resolved.connection
+		});
+	}
+	#withBaseSource(input) {
+		if (!input.sourceId) return input;
+		const scoped = decodeScopedSourceId(input.sourceId);
+		return scoped ? {
+			...input,
+			sourceId: scoped.sourceId
+		} : input;
 	}
 	workers(ctx) {
 		if (!incidentioReconciliationEnabled()) return [];
@@ -39,18 +377,29 @@ var PlatformIncidentioIntegration = class {
 			...intervalMs ? { intervalMs } : {}
 		})];
 	}
-	routes() {
-		return [];
+	/**
+	* The integration's HTTP surface: `/web/incidentio/*` Mastra `apiRoutes`
+	* (status + follow-up listing/detail for Intake), aggregated across every
+	* discovered Platform connection. A board-scoped listing also feeds the
+	* incident.io event rules.
+	*/
+	routes(ctx) {
+		return buildIncidentioRoutes({
+			incidentio: this,
+			auth: ctx.auth,
+			intake: ctx.storage.intake,
+			ingestFactoryIssues: attachIncidentioRules(this, ctx)
+		});
 	}
 	diagnostics() {
 		return {
+			configured: true,
 			mode: "platform",
-			endpointHost: this.#endpointHost,
-			connectionConfigured: true
+			endpointHost: this.#endpointHost
 		};
 	}
 };
 //#endregion
-export { PlatformIncidentioIntegration };
+export { PlatformIncidentioIntegration, decodeScopedSourceId, encodeScopedSourceId };
 
 //# sourceMappingURL=integration.js.map

package/dist/integrations/platform/incidentio/integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"integration.js","names":["#endpointHost"],"sources":["../../../../src/integrations/platform/incidentio/integration.ts"],"sourcesContent":["import type { MastraWorker } from '@mastra/core/worker';\n\nimport type { FactoryIntegration, IntegrationContext } from '../../base.js';\nimport { IncidentioApiClient } from '../../incidentio/api.js';\nimport { createIncidentioIntake } from '../../incidentio/intake.js';\nimport { attachIncidentioIssueReconciler } from '../../incidentio/issue-reconciler.js';\nimport {\n  incidentioReconciliationEnabled,\n  incidentioReconciliationInterval,\n} from '../../incidentio/reconciliation-config.js';\nimport { IssueReconcileWorker } from '../../issue-reconcile-worker.js';\nimport { platformApiClientConfigFromEnv, type PlatformApiClientConfig } from '../api-client.js';\n\nexport interface PlatformIncidentioIntegrationConfig {\n  clientConfig?: PlatformApiClientConfig;\n  connectionId?: string;\n}\n\nconst CONNECTION_TOKEN_PREFIX = 'incidentio-connection:';\n\nexport class PlatformIncidentioIntegration implements FactoryIntegration {\n  readonly id = 'incidentio';\n  readonly intake;\n  readonly #endpointHost: string;\n\n  constructor(config: PlatformIncidentioIntegrationConfig = {}) {\n    const connectionId = config.connectionId?.trim() || process.env.MASTRA_INCIDENT_IO_CONNECTION_ID?.trim();\n    if (!connectionId) {\n      throw new Error('PlatformIncidentioIntegration: missing required MASTRA_INCIDENT_IO_CONNECTION_ID.');\n    }\n\n    const clientConfig = config.clientConfig ?? platformApiClientConfigFromEnv();\n    this.#endpointHost = new URL(clientConfig.baseUrl).host;\n    const proxyBaseUrl = `${clientConfig.baseUrl.replace(/\\/+$/, '')}/v2/connections/${encodeURIComponent(\n      connectionId,\n    )}/proxy`;\n\n    this.intake = createIncidentioIntake({\n      api: new IncidentioApiClient({\n        baseUrl: proxyBaseUrl,\n        accessToken: clientConfig.accessToken,\n        ...(clientConfig.fetchImpl ? { fetchImpl: clientConfig.fetchImpl } : {}),\n      }),\n      connection: { type: 'oauth', accessToken: `${CONNECTION_TOKEN_PREFIX}${connectionId}` },\n    });\n  }\n\n  workers(ctx: IntegrationContext): MastraWorker[] {\n    if (!incidentioReconciliationEnabled()) return [];\n    const reconcile = attachIncidentioIssueReconciler(this, ctx);\n    if (!reconcile) return [];\n    const intervalMs = incidentioReconciliationInterval();\n    return [\n      new IssueReconcileWorker({\n        integrationId: this.id,\n        reconcile,\n        ...(intervalMs ? { intervalMs } : {}),\n      }),\n    ];\n  }\n\n  routes(): [] {\n    return [];\n  }\n\n  diagnostics(): Record<string, unknown> {\n    return { mode: 'platform', endpointHost: this.#endpointHost, connectionConfigured: true };\n  }\n}\n"],"mappings":";;;;;;;AAkBA,MAAM,0BAA0B;AAEhC,IAAa,gCAAb,MAAyE;CACvE,KAAc;CACd;CACA;CAEA,YAAY,SAA8C,CAAC,GAAG;EAC5D,MAAM,eAAe,OAAO,cAAc,KAAK,KAAK,QAAQ,IAAI,kCAAkC,KAAK;EACvG,IAAI,CAAC,cACH,MAAM,IAAI,MAAM,mFAAmF;EAGrG,MAAM,eAAe,OAAO,gBAAgB,+BAA+B;EAC3E,KAAKA,gBAAgB,IAAI,IAAI,aAAa,OAAO,CAAC,CAAC;EACnD,MAAM,eAAe,GAAG,aAAa,QAAQ,QAAQ,QAAQ,EAAE,EAAE,kBAAkB,mBACjF,YACF,EAAE;EAEF,KAAK,SAAS,uBAAuB;GACnC,KAAK,IAAI,oBAAoB;IAC3B,SAAS;IACT,aAAa,aAAa;IAC1B,GAAI,aAAa,YAAY,EAAE,WAAW,aAAa,UAAU,IAAI,CAAC;GACxE,CAAC;GACD,YAAY;IAAE,MAAM;IAAS,aAAa,GAAG,0BAA0B;GAAe;EACxF,CAAC;CACH;CAEA,QAAQ,KAAyC;EAC/C,IAAI,CAAC,gCAAgC,GAAG,OAAO,CAAC;EAChD,MAAM,YAAY,gCAAgC,MAAM,GAAG;EAC3D,IAAI,CAAC,WAAW,OAAO,CAAC;EACxB,MAAM,aAAa,iCAAiC;EACpD,OAAO,CACL,IAAI,qBAAqB;GACvB,eAAe,KAAK;GACpB;GACA,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;EACrC,CAAC,CACH;CACF;CAEA,SAAa;EACX,OAAO,CAAC;CACV;CAEA,cAAuC;EACrC,OAAO;GAAE,MAAM;GAAY,cAAc,KAAKA;GAAe,sBAAsB;EAAK;CAC1F;AACF"}
+{"version":3,"file":"integration.js","names":["#clientConfig","#platformClient","#endpointHost","#intakeByConnectionId","#rules","#orgIdByResourceId","#projects","#auth","#intakeStorage","#activeConnections","#connectionContexts","#connectionIntake","#intakeForConnection","#resolveIntakeDispatch","#listSources","#listItems","#listIssues","#getIssue","#createComment","#updateIssue","#scopeResolvedDispatch","#withBaseSource"],"sources":["../../../../src/integrations/platform/incidentio/integration.ts"],"sourcesContent":["import type { RequestContext } from '@mastra/core/request-context';\nimport type { ApiRoute } from '@mastra/core/server';\nimport type { MastraWorker } from '@mastra/core/worker';\n\nimport type { IntegrationConnection } from '../../../capabilities/connection.js';\nimport type {\n  CreateIntakeCommentInput,\n  CreatedIntakeComment,\n  GetIntakeIssueInput,\n  Intake,\n  IntakeIssue,\n  IntakeIssueDetail,\n  IntakeItemPage,\n  IntakeSource,\n  ListIntakeIssuesInput,\n  ListIntakeItemsInput,\n  ResolveIntakeDispatchInput,\n  ResolvedIntakeDispatch,\n  UpdateIntakeIssueInput,\n} from '../../../capabilities/intake.js';\nimport type { RouteAuth } from '../../../routes/route.js';\nimport type { IntakeStorage } from '../../../storage/domains/intake/base.js';\nimport type { FactoryProjectsStorage } from '../../../storage/domains/projects/base.js';\nimport type { FactoryIntegration, IntegrationContext, IntegrationTools } from '../../base.js';\nimport { buildIncidentioAgentTools } from '../../incidentio/agent-tools.js';\nimport { IncidentioApiClient, IncidentioApiError } from '../../incidentio/api.js';\nimport { resolveIncidentioRules } from '../../incidentio/default-rules.js';\nimport type { IncidentioEventRules, IncidentioRuleOverrides } from '../../incidentio/default-rules.js';\nimport {\n  createIncidentioIntake,\n  INCIDENTIO_FOLLOW_UPS_SOURCE_ID,\n  INCIDENTIO_INCIDENTS_SOURCE_ID,\n} from '../../incidentio/intake.js';\nimport { attachIncidentioIssueReconciler } from '../../incidentio/issue-reconciler.js';\nimport {\n  incidentioReconciliationEnabled,\n  incidentioReconciliationInterval,\n} from '../../incidentio/reconciliation-config.js';\nimport { buildIncidentioRoutes } from '../../incidentio/routes.js';\nimport { attachIncidentioRules } from '../../incidentio/rules.js';\nimport { IssueReconcileWorker } from '../../issue-reconcile-worker.js';\nimport { PlatformApiClient, platformApiClientConfigFromEnv, type PlatformApiClientConfig } from '../api-client.js';\n\nexport interface PlatformIncidentioIntegrationConfig {\n  clientConfig?: PlatformApiClientConfig;\n  /** Per-event replacements for the default Factory incident.io rules. */\n  rules?: IncidentioRuleOverrides;\n}\n\n/**\n * Provider config key registered for incident.io in Mastra Platform's\n * integrations catalog. Connections are discovered at runtime — no\n * deploy-time connection ID wiring.\n */\nconst PLATFORM_INCIDENTIO_PROVIDER_CONFIG_KEY = 'incident-io';\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\nconst CONNECTION_TOKEN_PREFIX = 'incidentio-connection:';\nconst SCOPED_SOURCE_PREFIX = 'incidentio-source:';\nconst BASE_SOURCE_IDS = [INCIDENTIO_INCIDENTS_SOURCE_ID, INCIDENTIO_FOLLOW_UPS_SOURCE_ID] as const;\n\ninterface PlatformIntegrationConnection {\n  id: string;\n  integrationId: string;\n  status: 'active' | 'needs_reauth';\n  accountLabel: string | null;\n}\n\ninterface ScopedSourceId {\n  connectionId: string;\n  sourceId: string;\n}\n\n/** An intake plus the exact inner connection it was resolved for, so operations discover active connections once. */\ninterface ResolvedIncidentioIntake {\n  intake: Intake;\n  connection: IntegrationConnection;\n}\n\ninterface AggregatePageCursor {\n  /** Connection ID the cursor points at; keyed by ID so the active list can change between pages. */\n  connectionId: string;\n  inner?: string;\n}\n\nexport function encodeScopedSourceId(connectionId: string, sourceId: string): string {\n  return `${SCOPED_SOURCE_PREFIX}${Buffer.from(JSON.stringify({ connectionId, sourceId })).toString('base64url')}`;\n}\n\nexport function decodeScopedSourceId(value: string): ScopedSourceId | null {\n  if (!value.startsWith(SCOPED_SOURCE_PREFIX)) return null;\n  try {\n    const parsed = JSON.parse(\n      Buffer.from(value.slice(SCOPED_SOURCE_PREFIX.length), 'base64url').toString('utf8'),\n    ) as Record<string, unknown>;\n    return typeof parsed.connectionId === 'string' && typeof parsed.sourceId === 'string'\n      ? { connectionId: parsed.connectionId, sourceId: parsed.sourceId }\n      : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction incidentioConnection(connectionId: string): IntegrationConnection {\n  return { type: 'oauth', accessToken: `${CONNECTION_TOKEN_PREFIX}${connectionId}` };\n}\n\nfunction connectionIdFromConnection(connection: IntegrationConnection): string | null {\n  if (connection.type !== 'oauth' || !connection.accessToken.startsWith(CONNECTION_TOKEN_PREFIX)) return null;\n  return connection.accessToken.slice(CONNECTION_TOKEN_PREFIX.length) || null;\n}\n\n/**\n * Base (per-connection) source ids selected for a connection. Scoped ids\n * select their own connection; legacy unscoped ids (`incidentio:incidents`)\n * from pre-discovery deploys apply to every connection.\n */\nfunction baseSourceIdsFor(connectionId: string, sourceIds: string[]): string[] {\n  const selected = new Set<string>();\n  for (const sourceId of sourceIds) {\n    const scoped = decodeScopedSourceId(sourceId);\n    if (scoped) {\n      if (scoped.connectionId === connectionId) selected.add(scoped.sourceId);\n      continue;\n    }\n    if ((BASE_SOURCE_IDS as readonly string[]).includes(sourceId)) selected.add(sourceId);\n  }\n  return [...selected];\n}\n\nfunction encodePageCursor(cursor: AggregatePageCursor): string {\n  return Buffer.from(JSON.stringify(cursor)).toString('base64url');\n}\n\nfunction decodePageCursor(cursor: string | undefined): AggregatePageCursor | null {\n  if (!cursor) return null;\n  try {\n    const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8')) as Partial<AggregatePageCursor>;\n    if (typeof parsed.connectionId !== 'string' || !parsed.connectionId) return null;\n    return {\n      connectionId: parsed.connectionId,\n      ...(typeof parsed.inner === 'string' && parsed.inner ? { inner: parsed.inner } : {}),\n    };\n  } catch {\n    return null;\n  }\n}\n\ninterface IncidentioConnectionContext {\n  connection: PlatformIntegrationConnection;\n  intake: Intake;\n}\n\nexport class PlatformIncidentioIntegration implements FactoryIntegration {\n  readonly id = 'incidentio';\n  readonly #clientConfig: PlatformApiClientConfig;\n  readonly #platformClient: PlatformApiClient;\n  readonly #endpointHost: string;\n  readonly #intakeByConnectionId = new Map<string, Intake>();\n  readonly #rules: IncidentioEventRules;\n\n  /** Bound once by the factory via `initialize()` before any surface is used. */\n  #projects: FactoryProjectsStorage | undefined;\n  #auth: RouteAuth | undefined;\n  #intakeStorage: IntakeStorage | undefined;\n  readonly #orgIdByResourceId = new Map<string, string | null>();\n\n  constructor(config: PlatformIncidentioIntegrationConfig = {}) {\n    this.#clientConfig = config.clientConfig ?? platformApiClientConfigFromEnv();\n    this.#platformClient = new PlatformApiClient(this.#clientConfig);\n    this.#endpointHost = new URL(this.#clientConfig.baseUrl).host;\n    this.#rules = resolveIncidentioRules(config.rules);\n  }\n\n  /** Event rules driving automatic follow-up materialization and close handling. */\n  get rules(): IncidentioEventRules {\n    return this.#rules;\n  }\n\n  initialize({\n    projects,\n    auth,\n    intake,\n  }: {\n    projects: FactoryProjectsStorage;\n    auth: RouteAuth;\n    intake: IntakeStorage;\n  }): void {\n    this.#projects = projects;\n    this.#auth = auth;\n    this.#intakeStorage = intake;\n  }\n\n  /** Cross-integration intake selection/binding domain — agent-tool authorization. */\n  get intakeStorage(): IntakeStorage {\n    if (!this.#intakeStorage) {\n      throw new Error('PlatformIncidentioIntegration is not initialized — the factory binds storage during prepare().');\n    }\n    return this.#intakeStorage;\n  }\n\n  /** Factory projects domain — maps a session's resourceId to its owning org. */\n  get projects(): FactoryProjectsStorage {\n    if (!this.#projects) {\n      throw new Error('PlatformIncidentioIntegration is not initialized — the factory binds storage during prepare().');\n    }\n    return this.#projects;\n  }\n\n  /** Whether the host runs with web auth enabled; every surface is inert without it. */\n  get authEnabled(): boolean {\n    return this.#auth?.enabled() ?? false;\n  }\n\n  /**\n   * Map a session's resourceId (the factory project id) to its owning org.\n   * Same caching semantics as the Jira integration: definitive misses are\n   * cached, transient database failures are not.\n   */\n  async resolveOrgId(resourceId: string): Promise<string | null> {\n    const cached = this.#orgIdByResourceId.get(resourceId);\n    if (cached !== undefined) return cached;\n    if (!UUID_RE.test(resourceId)) {\n      this.#orgIdByResourceId.set(resourceId, null);\n      return null;\n    }\n    let orgId: string | null;\n    try {\n      await this.projects.ensureReady();\n      const project = await this.projects.getById({ id: resourceId });\n      orgId = project?.orgId ?? null;\n    } catch {\n      // Transient database failure: skip the tools for this request but don't\n      // cache the miss, so the next request retries the lookup.\n      return null;\n    }\n    this.#orgIdByResourceId.set(resourceId, orgId);\n    return orgId;\n  }\n\n  /**\n   * Org-scoped agent tools: the read-only follow-up detail tool for sessions\n   * whose resource is a factory project with an active Platform-managed\n   * incident.io connection.\n   */\n  async agentTools(args: { requestContext: RequestContext }): Promise<IntegrationTools> {\n    if (!(await this.hasActiveConnections())) return {};\n    return buildIncidentioAgentTools({ requestContext: args.requestContext, incidentio: this });\n  }\n\n  async listConnections(): Promise<PlatformIntegrationConnection[]> {\n    const providerKey = encodeURIComponent(PLATFORM_INCIDENTIO_PROVIDER_CONFIG_KEY);\n    const result = await this.#platformClient.request<{ connections: PlatformIntegrationConnection[] }>(\n      'GET',\n      `/v2/connections?providerKey=${providerKey}`,\n    );\n    return result.connections;\n  }\n\n  async hasActiveConnections(): Promise<boolean> {\n    return (await this.#activeConnections()).length > 0;\n  }\n\n  clearCaches(): void {\n    this.#intakeByConnectionId.clear();\n    this.#orgIdByResourceId.clear();\n  }\n\n  async #activeConnections(): Promise<PlatformIntegrationConnection[]> {\n    const connections = (await this.listConnections()).filter(connection => connection.status === 'active');\n    // Stable ordering keeps aggregate page cursors valid across requests.\n    return connections.slice().sort((left, right) => left.id.localeCompare(right.id));\n  }\n\n  #connectionIntake(connectionId: string): Intake {\n    const cached = this.#intakeByConnectionId.get(connectionId);\n    if (cached) return cached;\n    const proxyBaseUrl = `${this.#clientConfig.baseUrl.replace(/\\/+$/, '')}/v2/connections/${encodeURIComponent(\n      connectionId,\n    )}/proxy`;\n    const intake = createIncidentioIntake({\n      api: new IncidentioApiClient({\n        baseUrl: proxyBaseUrl,\n        accessToken: this.#clientConfig.accessToken,\n        ...(this.#clientConfig.fetchImpl ? { fetchImpl: this.#clientConfig.fetchImpl } : {}),\n      }),\n      connection: incidentioConnection(connectionId),\n    });\n    this.#intakeByConnectionId.set(connectionId, intake);\n    return intake;\n  }\n\n  async #connectionContexts(): Promise<IncidentioConnectionContext[]> {\n    return (await this.#activeConnections()).map(connection => ({\n      connection,\n      intake: this.#connectionIntake(connection.id),\n    }));\n  }\n\n  /**\n   * Resolve the intake for an explicit connection token, or fall back to the\n   * sole active connection so legacy single-connection callers keep working.\n   *\n   * A caller-supplied connection token is only a claim: the id it carries\n   * must match a connection the deployment actually discovered as active\n   * before any proxy request is minted with the Platform credential.\n   */\n  async #intakeForConnection(connection: IntegrationConnection): Promise<ResolvedIncidentioIntake> {\n    const connectionId = connectionIdFromConnection(connection);\n    const active = await this.#activeConnections();\n    if (connectionId) {\n      if (!active.some(candidate => candidate.id === connectionId)) {\n        throw new IncidentioApiError('incident.io connection is unavailable or requires reauthentication.', 401);\n      }\n      return { intake: this.#connectionIntake(connectionId), connection: incidentioConnection(connectionId) };\n    }\n    if (active.length === 1) {\n      const soleId = active[0]!.id;\n      return { intake: this.#connectionIntake(soleId), connection: incidentioConnection(soleId) };\n    }\n    throw new IncidentioApiError(\n      active.length === 0\n        ? 'incident.io connection is unavailable or requires reauthentication.'\n        : 'incident.io request must identify a connection when multiple accounts are connected.',\n      active.length === 0 ? 401 : 400,\n    );\n  }\n\n  readonly intake: Intake = {\n    resolveIntakeDispatch: input => this.#resolveIntakeDispatch(input),\n    listSources: () => this.#listSources(),\n    listItems: input => this.#listItems(input),\n    listIssues: input => this.#listIssues(input),\n    getIssue: input => this.#getIssue(input),\n    createComment: input => this.#createComment(input),\n    updateIssue: input => this.#updateIssue(input),\n  };\n\n  async #resolveIntakeDispatch(input: ResolveIntakeDispatchInput): Promise<ResolvedIntakeDispatch | null> {\n    if (input.externalSource.type !== 'issue') return null;\n    const externalId = input.externalSource.externalId;\n    const contexts = await this.#connectionContexts();\n    if (contexts.length === 0) return null;\n    if (contexts.length === 1) {\n      const resolved = await contexts[0]!.intake.resolveIntakeDispatch?.(input);\n      return resolved ? this.#scopeResolvedDispatch(contexts[0]!.connection.id, resolved) : null;\n    }\n    // Multiple accounts: item references carry no connection id, so probe\n    // each connection for the item — first account that knows it wins\n    // (incident.io ids are globally unique ULIDs, collisions are not a\n    // practical concern and this capability is read-mostly).\n    let firstError: unknown;\n    for (const context of contexts) {\n      try {\n        const issue = await context.intake.getIssue({\n          connection: incidentioConnection(context.connection.id),\n          issueId: externalId,\n        });\n        if (!issue) continue;\n        const resolved = await context.intake.resolveIntakeDispatch?.(input);\n        return resolved ? this.#scopeResolvedDispatch(context.connection.id, resolved) : null;\n      } catch (error) {\n        if (error instanceof IncidentioApiError && error.status === 404) continue;\n        firstError ??= error;\n      }\n    }\n    if (firstError !== undefined) throw firstError;\n    return null;\n  }\n\n  #scopeResolvedDispatch(connectionId: string, resolved: ResolvedIntakeDispatch): ResolvedIntakeDispatch {\n    return {\n      ...resolved,\n      connection: incidentioConnection(connectionId),\n      ...(resolved.sourceId ? { sourceId: encodeScopedSourceId(connectionId, resolved.sourceId) } : {}),\n    };\n  }\n\n  async #listSources(): Promise<IntakeSource[]> {\n    const contexts = await this.#connectionContexts();\n    const sources: IntakeSource[] = [];\n    for (const context of contexts) {\n      const account = context.connection.accountLabel;\n      const inner = await context.intake.listSources({ orgId: '', userId: '' });\n      for (const source of inner) {\n        sources.push({\n          ...source,\n          id: encodeScopedSourceId(context.connection.id, source.id),\n          name: contexts.length > 1 && account ? `${source.name} (${account})` : source.name,\n          metadata: {\n            ...(source.metadata ?? {}),\n            connectionId: context.connection.id,\n            ...(account ? { account } : {}),\n          },\n        });\n      }\n    }\n    return sources;\n  }\n\n  async #listItems(input: ListIntakeItemsInput): Promise<IntakeItemPage> {\n    if (input.sourceIds.length === 0) return { items: [], nextCursor: null };\n    const contexts = await this.#connectionContexts();\n    const cursor = decodePageCursor(input.cursor);\n\n    // Resume by connection ID: the active list can change between pages, so an\n    // index would replay or skip connections. When the cursor's connection is\n    // gone, resume at its sorted successor and drop the inner cursor.\n    let startIndex = 0;\n    let exactMatch = false;\n    if (cursor) {\n      const index = contexts.findIndex(context => context.connection.id === cursor.connectionId);\n      exactMatch = index !== -1;\n      startIndex = exactMatch\n        ? index\n        : contexts.findIndex(context => context.connection.id.localeCompare(cursor.connectionId) > 0);\n      if (startIndex === -1) return { items: [], nextCursor: null };\n    }\n\n    for (let index = startIndex; index < contexts.length; index++) {\n      const context = contexts[index]!;\n      const baseSourceIds = baseSourceIdsFor(context.connection.id, input.sourceIds);\n      if (baseSourceIds.length === 0) continue;\n      const page = await context.intake.listItems({\n        orgId: input.orgId,\n        userId: input.userId,\n        sourceIds: baseSourceIds,\n        ...(index === startIndex && exactMatch && cursor?.inner ? { cursor: cursor.inner } : {}),\n      });\n      const nextCursor = page.nextCursor\n        ? encodePageCursor({ connectionId: context.connection.id, inner: page.nextCursor })\n        : index + 1 < contexts.length\n          ? encodePageCursor({ connectionId: contexts[index + 1]!.connection.id })\n          : null;\n      return {\n        items: page.items.map(item => ({\n          ...item,\n          sourceId: encodeScopedSourceId(context.connection.id, item.sourceId),\n          metadata: { ...(item.metadata ?? {}), connectionId: context.connection.id },\n        })),\n        nextCursor,\n      };\n    }\n    return { items: [], nextCursor: null };\n  }\n\n  async #listIssues(input: ListIntakeIssuesInput): Promise<{ issues: IntakeIssue[]; nextCursor: string | null }> {\n    const resolved = await this.#intakeForConnection(input.connection);\n    // Scope to the connection that was actually resolved (which may be the\n    // sole-connection fallback), so a source id scoped to a different\n    // connection is dropped instead of being read against this one.\n    const connectionId = connectionIdFromConnection(resolved.connection);\n    const baseSourceIds = connectionId\n      ? baseSourceIdsFor(connectionId, input.sourceIds)\n      : input.sourceIds.map(sourceId => decodeScopedSourceId(sourceId)?.sourceId ?? sourceId);\n    return resolved.intake.listIssues({\n      ...input,\n      connection: resolved.connection,\n      sourceIds: baseSourceIds,\n    });\n  }\n\n  async #getIssue(input: GetIntakeIssueInput): Promise<IntakeIssueDetail | null> {\n    const resolved = await this.#intakeForConnection(input.connection);\n    return resolved.intake.getIssue({\n      ...this.#withBaseSource(input),\n      connection: resolved.connection,\n    });\n  }\n\n  async #createComment(input: CreateIntakeCommentInput): Promise<CreatedIntakeComment | null> {\n    const resolved = await this.#intakeForConnection(input.connection);\n    return resolved.intake.createComment({\n      ...this.#withBaseSource(input),\n      connection: resolved.connection,\n    });\n  }\n\n  async #updateIssue(input: UpdateIntakeIssueInput): Promise<IntakeIssue | null> {\n    const resolved = await this.#intakeForConnection(input.connection);\n    return resolved.intake.updateIssue({\n      ...this.#withBaseSource(input),\n      connection: resolved.connection,\n    });\n  }\n\n  #withBaseSource<T extends { sourceId?: string }>(input: T): T {\n    if (!input.sourceId) return input;\n    const scoped = decodeScopedSourceId(input.sourceId);\n    return scoped ? { ...input, sourceId: scoped.sourceId } : input;\n  }\n\n  workers(ctx: IntegrationContext): MastraWorker[] {\n    if (!incidentioReconciliationEnabled()) return [];\n    const reconcile = attachIncidentioIssueReconciler(this, ctx);\n    if (!reconcile) return [];\n    const intervalMs = incidentioReconciliationInterval();\n    return [\n      new IssueReconcileWorker({\n        integrationId: this.id,\n        reconcile,\n        ...(intervalMs ? { intervalMs } : {}),\n      }),\n    ];\n  }\n\n  /**\n   * The integration's HTTP surface: `/web/incidentio/*` Mastra `apiRoutes`\n   * (status + follow-up listing/detail for Intake), aggregated across every\n   * discovered Platform connection. A board-scoped listing also feeds the\n   * incident.io event rules.\n   */\n  routes(ctx: IntegrationContext): ApiRoute[] {\n    return buildIncidentioRoutes({\n      incidentio: this,\n      auth: ctx.auth,\n      intake: ctx.storage.intake,\n      ingestFactoryIssues: attachIncidentioRules(this, ctx),\n    });\n  }\n\n  diagnostics(): Record<string, unknown> {\n    return { configured: true, mode: 'platform', endpointHost: this.#endpointHost };\n  }\n}\n"],"mappings":"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"}

package/dist/integrations/platform/jira/agent-tools.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Jira tools exposed to the coding agent — `jira_get_issue` for reads and
+ * `jira_create_comment` for posting findings back to the issue, matching the
+ * Linear tool surface.
+ *
+ * Wired into the agent through the SDK's async `extraTools` provider: on each
+ * tool-set resolution we map the session's resourceId (the factory project
+ * id) to its owning org and only expose the Jira tools for real factory
+ * projects with an active Platform-managed Jira connection.
+ *
+ * Tenancy mirrors the Jira API routes: nothing is exposed without the host
+ * auth seam, and the session must resolve to an org-owned project.
+ */
+import type { RequestContext } from '@mastra/core/request-context';
+import type { PlatformJiraIntegration } from './integration.js';
+declare function createJiraGetIssueTool(jira: PlatformJiraIntegration): import("@mastra/core/tools").Tool<{
+    issue: string;
+}, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "jira_get_issue", unknown>;
+declare function createJiraCommentTool(jira: PlatformJiraIntegration): import("@mastra/core/tools").Tool<{
+    issue: string;
+    body: string;
+}, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "jira_create_comment", unknown>;
+/**
+ * Async `extraTools` provider: expose the Jira tools only when the host runs
+ * with web auth and the session's resource is an org-owned factory project.
+ *
+ * Intake source bindings scope the board feed; both tools resolve the issue
+ * through one of the organization's active Platform Jira connections.
+ */
+export declare function buildPlatformJiraAgentTools({ requestContext, jira, }: {
+    requestContext: RequestContext;
+    /** The integration instance providing the Jira API client. */
+    jira: PlatformJiraIntegration;
+}): Promise<Record<string, ReturnType<typeof createJiraGetIssueTool> | ReturnType<typeof createJiraCommentTool>>>;
+export {};
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/integrations/platform/jira/agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../../../src/integrations/platform/jira/agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAOnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAYhE,iBAAS,sBAAsB,CAAC,IAAI,EAAE,uBAAuB;;uIAuB5D;AAED,iBAAS,qBAAqB,CAAC,IAAI,EAAE,uBAAuB;;;4IAyB3D;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,EAChD,cAAc,EACd,IAAI,GACL,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,8DAA8D;IAC9D,IAAI,EAAE,uBAAuB,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAmBhH"}

package/dist/integrations/platform/jira/agent-tools.js

@@ -0,0 +1,85 @@
+import { JiraApiError } from "../../jira/api.js";
+import { JIRA_UNTRUSTED_CONTENT_NOTICE } from "../../jira/agent-tools.js";
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+//#region src/integrations/platform/jira/agent-tools.ts
+/** The `Intake` contract requires a connection argument; the Platform adapter resolves the real connection. */
+const PLATFORM_CONNECTION = {
+	type: "oauth",
+	accessToken: "platform-managed"
+};
+function toolError(action, err) {
+	if (err instanceof JiraApiError && err.code === "jira_auth_failed") return { error: "Jira rejected the connected account. Reconnect it in Mastra Platform." };
+	return { error: `${action}: ${err instanceof Error ? err.message : String(err)}` };
+}
+function createJiraGetIssueTool(jira) {
+	return createTool({
+		id: "jira_get_issue",
+		description: "Fetch a Jira issue's full details — summary, description, status, assignee, labels, priority, and discussion comments. Use this whenever you're working on a Jira issue (e.g. ENG-123) to get its complete context.",
+		inputSchema: z.object({ issue: z.string().trim().min(1).describe("The Jira issue key (e.g. \"ENG-123\") or numeric issue id.") }),
+		execute: async ({ issue }) => {
+			try {
+				const detail = await jira.intake.getIssue({
+					connection: PLATFORM_CONNECTION,
+					issueId: issue
+				});
+				if (!detail) return { error: `Jira issue "${issue}" was not found on this site.` };
+				return {
+					notice: JIRA_UNTRUSTED_CONTENT_NOTICE,
+					...detail
+				};
+			} catch (err) {
+				return toolError("Failed to fetch Jira issue", err);
+			}
+		}
+	});
+}
+function createJiraCommentTool(jira) {
+	return createTool({
+		id: "jira_create_comment",
+		description: "Post a comment on a Jira issue (e.g. to report investigation findings, link a PR, or ask a clarifying question). The comment is posted as the connected Jira account, so make clear it comes from the agent.",
+		inputSchema: z.object({
+			issue: z.string().trim().min(1).describe("The Jira issue key (e.g. \"ENG-123\") or numeric issue id."),
+			body: z.string().min(1).describe("The comment body, as plain text.")
+		}),
+		execute: async ({ issue, body }) => {
+			try {
+				const comment = await jira.intake.createComment({
+					connection: PLATFORM_CONNECTION,
+					issueId: issue,
+					body
+				});
+				if (!comment) return { error: `Jira issue "${issue}" was not found on this site.` };
+				return {
+					posted: true,
+					url: comment.url
+				};
+			} catch (err) {
+				return toolError("Failed to post Jira comment", err);
+			}
+		}
+	});
+}
+/**
+* Async `extraTools` provider: expose the Jira tools only when the host runs
+* with web auth and the session's resource is an org-owned factory project.
+*
+* Intake source bindings scope the board feed; both tools resolve the issue
+* through one of the organization's active Platform Jira connections.
+*/
+async function buildPlatformJiraAgentTools({ requestContext, jira }) {
+	if (!jira.authEnabled) return {};
+	const ctx = requestContext.get("controller");
+	if (!ctx) return {};
+	const projectId = ctx.getState().factoryProjectId ?? ctx.resourceId;
+	if (!projectId) return {};
+	if (!await jira.resolveOrgId(projectId) || !await jira.hasActiveConnections()) return {};
+	return {
+		jira_get_issue: createJiraGetIssueTool(jira),
+		jira_create_comment: createJiraCommentTool(jira)
+	};
+}
+//#endregion
+export { buildPlatformJiraAgentTools };
+
+//# sourceMappingURL=agent-tools.js.map

package/dist/integrations/platform/jira/agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.js","names":[],"sources":["../../../../src/integrations/platform/jira/agent-tools.ts"],"sourcesContent":["/**\n * Jira tools exposed to the coding agent — `jira_get_issue` for reads and\n * `jira_create_comment` for posting findings back to the issue, matching the\n * Linear tool surface.\n *\n * Wired into the agent through the SDK's async `extraTools` provider: on each\n * tool-set resolution we map the session's resourceId (the factory project\n * id) to its owning org and only expose the Jira tools for real factory\n * projects with an active Platform-managed Jira connection.\n *\n * Tenancy mirrors the Jira API routes: nothing is exposed without the host\n * auth seam, and the session must resolve to an org-owned project.\n */\n\nimport type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport type { IntegrationConnection } from '../../../capabilities/connection.js';\nimport { JIRA_UNTRUSTED_CONTENT_NOTICE } from '../../jira/agent-tools.js';\nimport { JiraApiError } from '../../jira/api.js';\nimport type { PlatformJiraIntegration } from './integration.js';\n\n/** The `Intake` contract requires a connection argument; the Platform adapter resolves the real connection. */\nconst PLATFORM_CONNECTION: IntegrationConnection = { type: 'oauth', accessToken: 'platform-managed' };\n\nfunction toolError(action: string, err: unknown): { error: string } {\n  if (err instanceof JiraApiError && err.code === 'jira_auth_failed') {\n    return { error: 'Jira rejected the connected account. Reconnect it in Mastra Platform.' };\n  }\n  return { error: `${action}: ${err instanceof Error ? err.message : String(err)}` };\n}\n\nfunction createJiraGetIssueTool(jira: PlatformJiraIntegration) {\n  return createTool({\n    id: 'jira_get_issue',\n    description:\n      \"Fetch a Jira issue's full details — summary, description, status, assignee, labels, priority, and discussion comments. Use this whenever you're working on a Jira issue (e.g. ENG-123) to get its complete context.\",\n    inputSchema: z.object({\n      issue: z.string().trim().min(1).describe('The Jira issue key (e.g. \"ENG-123\") or numeric issue id.'),\n    }),\n    execute: async ({ issue }: { issue: string }) => {\n      try {\n        const detail = await jira.intake.getIssue({\n          connection: PLATFORM_CONNECTION,\n          issueId: issue,\n        });\n        if (!detail) {\n          return { error: `Jira issue \"${issue}\" was not found on this site.` };\n        }\n        return { notice: JIRA_UNTRUSTED_CONTENT_NOTICE, ...detail };\n      } catch (err) {\n        return toolError('Failed to fetch Jira issue', err);\n      }\n    },\n  });\n}\n\nfunction createJiraCommentTool(jira: PlatformJiraIntegration) {\n  return createTool({\n    id: 'jira_create_comment',\n    description:\n      'Post a comment on a Jira issue (e.g. to report investigation findings, link a PR, or ask a clarifying question). The comment is posted as the connected Jira account, so make clear it comes from the agent.',\n    inputSchema: z.object({\n      issue: z.string().trim().min(1).describe('The Jira issue key (e.g. \"ENG-123\") or numeric issue id.'),\n      body: z.string().min(1).describe('The comment body, as plain text.'),\n    }),\n    execute: async ({ issue, body }: { issue: string; body: string }) => {\n      try {\n        const comment = await jira.intake.createComment({\n          connection: PLATFORM_CONNECTION,\n          issueId: issue,\n          body,\n        });\n        if (!comment) {\n          return { error: `Jira issue \"${issue}\" was not found on this site.` };\n        }\n        return { posted: true, url: comment.url };\n      } catch (err) {\n        return toolError('Failed to post Jira comment', err);\n      }\n    },\n  });\n}\n\n/**\n * Async `extraTools` provider: expose the Jira tools only when the host runs\n * with web auth and the session's resource is an org-owned factory project.\n *\n * Intake source bindings scope the board feed; both tools resolve the issue\n * through one of the organization's active Platform Jira connections.\n */\nexport async function buildPlatformJiraAgentTools({\n  requestContext,\n  jira,\n}: {\n  requestContext: RequestContext;\n  /** The integration instance providing the Jira API client. */\n  jira: PlatformJiraIntegration;\n}): Promise<Record<string, ReturnType<typeof createJiraGetIssueTool> | ReturnType<typeof createJiraCommentTool>>> {\n  if (!jira.authEnabled) return {};\n\n  const ctx = requestContext.get('controller') as\n    AgentControllerRequestContext<{ factoryProjectId?: string }> | undefined;\n  if (!ctx) return {};\n\n  // Board-run resourceId is the work-item session id, not the project id stored\n  // in factory_projects. Project-scoped sessions may not carry factoryProjectId.\n  const projectId = ctx.getState().factoryProjectId ?? ctx.resourceId;\n  if (!projectId) return {};\n\n  const orgId = await jira.resolveOrgId(projectId);\n  if (!orgId || !(await jira.hasActiveConnections())) return {};\n\n  return {\n    jira_get_issue: createJiraGetIssueTool(jira),\n    jira_create_comment: createJiraCommentTool(jira),\n  };\n}\n"],"mappings":";;;;;;AAyBA,MAAM,sBAA6C;CAAE,MAAM;CAAS,aAAa;AAAmB;AAEpG,SAAS,UAAU,QAAgB,KAAiC;CAClE,IAAI,eAAe,gBAAgB,IAAI,SAAS,oBAC9C,OAAO,EAAE,OAAO,wEAAwE;CAE1F,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,IAAI;AACnF;AAEA,SAAS,uBAAuB,MAA+B;CAC7D,OAAO,WAAW;EAChB,IAAI;EACJ,aACE;EACF,aAAa,EAAE,OAAO,EACpB,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,4DAA0D,EACrG,CAAC;EACD,SAAS,OAAO,EAAE,YAA+B;GAC/C,IAAI;IACF,MAAM,SAAS,MAAM,KAAK,OAAO,SAAS;KACxC,YAAY;KACZ,SAAS;IACX,CAAC;IACD,IAAI,CAAC,QACH,OAAO,EAAE,OAAO,eAAe,MAAM,+BAA+B;IAEtE,OAAO;KAAE,QAAQ;KAA+B,GAAG;IAAO;GAC5D,SAAS,KAAK;IACZ,OAAO,UAAU,8BAA8B,GAAG;GACpD;EACF;CACF,CAAC;AACH;AAEA,SAAS,sBAAsB,MAA+B;CAC5D,OAAO,WAAW;EAChB,IAAI;EACJ,aACE;EACF,aAAa,EAAE,OAAO;GACpB,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,4DAA0D;GACnG,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,kCAAkC;EACrE,CAAC;EACD,SAAS,OAAO,EAAE,OAAO,WAA4C;GACnE,IAAI;IACF,MAAM,UAAU,MAAM,KAAK,OAAO,cAAc;KAC9C,YAAY;KACZ,SAAS;KACT;IACF,CAAC;IACD,IAAI,CAAC,SACH,OAAO,EAAE,OAAO,eAAe,MAAM,+BAA+B;IAEtE,OAAO;KAAE,QAAQ;KAAM,KAAK,QAAQ;IAAI;GAC1C,SAAS,KAAK;IACZ,OAAO,UAAU,+BAA+B,GAAG;GACrD;EACF;CACF,CAAC;AACH;;;;;;;;AASA,eAAsB,4BAA4B,EAChD,gBACA,QAKgH;CAChH,IAAI,CAAC,KAAK,aAAa,OAAO,CAAC;CAE/B,MAAM,MAAM,eAAe,IAAI,YAAY;CAE3C,IAAI,CAAC,KAAK,OAAO,CAAC;CAIlB,MAAM,YAAY,IAAI,SAAS,CAAC,CAAC,oBAAoB,IAAI;CACzD,IAAI,CAAC,WAAW,OAAO,CAAC;CAGxB,IAAI,CAAC,MADe,KAAK,aAAa,SAAS,KACjC,CAAE,MAAM,KAAK,qBAAqB,GAAI,OAAO,CAAC;CAE5D,OAAO;EACL,gBAAgB,uBAAuB,IAAI;EAC3C,qBAAqB,sBAAsB,IAAI;CACjD;AACF"}