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

package/dist/tools/scope.js

@@ -0,0 +1,73 @@
+import { FACTORY_INTERACTIVE_KEY, factoryUserOrgId, getFactoryAuthUserFromContext, getFactoryAuthUserId } from "../auth.js";
+import { auditActorProfile } from "../storage/domains/audit/base.js";
+//#region src/tools/scope.ts
+/**
+* Resolve the Factory a session's agent may act in. The scope comes from the
+* stored source-control session row and the authenticated caller, never from
+* the `factoryProjectId` thread tag alone: the browser sets that tag and
+* nothing clears it.
+*/
+async function resolveFactoryToolScope({ requestContext, authEnabled, sessions, projects, workItems }) {
+	if (typeof requestContext?.get !== "function") return null;
+	const controller = requestContext.get("controller");
+	const resourceId = controller?.resourceId;
+	const threadId = controller?.threadId;
+	if (!resourceId || !threadId) return null;
+	let caller = null;
+	if (authEnabled) {
+		const user = getFactoryAuthUserFromContext(requestContext);
+		const userId = getFactoryAuthUserId(user);
+		const orgId = factoryUserOrgId(user);
+		const actorProfile = auditActorProfile(user);
+		if (userId && orgId) caller = {
+			orgId,
+			userId,
+			...actorProfile ? { actorProfile } : {}
+		};
+	} else caller = {
+		orgId: "local",
+		userId: "local"
+	};
+	const row = await sessions.getBySessionId(resourceId);
+	if (!row?.factoryProjectId) return null;
+	if (caller && row.orgId !== caller.orgId) return null;
+	const origin = row.originSessionId && row.originThreadId ? {
+		sessionId: row.originSessionId,
+		threadId: row.originThreadId
+	} : void 0;
+	const worker = origin !== void 0 || await workItems.hasRunBindingForSession({
+		orgId: row.orgId,
+		factoryProjectId: row.factoryProjectId,
+		sessionId: row.sessionId
+	});
+	let identity;
+	if (worker) identity = {
+		orgId: row.orgId,
+		userId: row.userId
+	};
+	else {
+		if (!caller) return null;
+		if (row.visibility === "private" && row.userId !== caller.userId) return null;
+		identity = caller;
+	}
+	if (!await projects.get({
+		orgId: identity.orgId,
+		id: row.factoryProjectId
+	})) return null;
+	return {
+		orgId: identity.orgId,
+		factoryProjectId: row.factoryProjectId,
+		userId: identity.userId,
+		sessionId: row.sessionId,
+		resourceId,
+		threadId,
+		kind: worker ? "worker" : "user",
+		interactive: requestContext.get(FACTORY_INTERACTIVE_KEY) === true,
+		...identity.actorProfile ? { actorProfile: identity.actorProfile } : {},
+		...origin ? { origin } : {}
+	};
+}
+//#endregion
+export { FACTORY_INTERACTIVE_KEY, resolveFactoryToolScope };
+
+//# sourceMappingURL=scope.js.map

package/dist/tools/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","names":[],"sources":["../../src/tools/scope.ts"],"sourcesContent":["import type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { RequestContext } from '@mastra/core/request-context';\n\nimport {\n  FACTORY_INTERACTIVE_KEY,\n  factoryUserOrgId,\n  getFactoryAuthUserFromContext,\n  getFactoryAuthUserId,\n} from '../auth.js';\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport { auditActorProfile } from '../storage/domains/audit/base.js';\nimport type { AuditActorProfileInput } from '../storage/domains/audit/base.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\n\nexport { FACTORY_INTERACTIVE_KEY };\n\n/** Who is calling Factory tools, and from which session. Everything a tool needs to stay in scope. */\nexport interface FactoryToolScope {\n  orgId: string;\n  factoryProjectId: string;\n  /** The signed-in caller for a user session; the session row's owner for a worker. */\n  userId: string;\n  /** The source-control session id; equal to the controller resourceId. */\n  sessionId: string;\n  resourceId: string;\n  threadId: string;\n  /** `worker` sessions are bound to a work item run; only `user` sessions manage the Factory. */\n  kind: 'user' | 'worker';\n  /** True only for turns a signed-in person started over HTTP (see {@link FACTORY_INTERACTIVE_KEY}). */\n  interactive: boolean;\n  /** The caller's name and avatar, stamped on audit events so the board can show who acted. */\n  actorProfile?: AuditActorProfileInput;\n  /** Set for a side session: the user session and thread that started it. */\n  origin?: { sessionId: string; threadId: string };\n}\n\nexport interface ResolveFactoryToolScopeOptions {\n  requestContext: RequestContext;\n  /** `routeAuth.enabled()`; when false every caller is the shared `local` tenant. */\n  authEnabled: boolean;\n  sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;\n  projects: Pick<FactoryProjectsStorage, 'get'>;\n  workItems: Pick<WorkItemsStorage, 'hasRunBindingForSession'>;\n}\n\n/**\n * Resolve the Factory a session's agent may act in. The scope comes from the\n * stored source-control session row and the authenticated caller, never from\n * the `factoryProjectId` thread tag alone: the browser sets that tag and\n * nothing clears it.\n */\nexport async function resolveFactoryToolScope({\n  requestContext,\n  authEnabled,\n  sessions,\n  projects,\n  workItems,\n}: ResolveFactoryToolScopeOptions): Promise<FactoryToolScope | null> {\n  if (typeof requestContext?.get !== 'function') return null;\n  const controller = requestContext.get('controller') as AgentControllerRequestContext<unknown> | undefined;\n  const resourceId = controller?.resourceId;\n  const threadId = controller?.threadId;\n  if (!resourceId || !threadId) return null;\n\n  let caller: { orgId: string; userId: string; actorProfile?: AuditActorProfileInput } | null = null;\n  if (authEnabled) {\n    const user = getFactoryAuthUserFromContext(requestContext);\n    const userId = getFactoryAuthUserId(user);\n    const orgId = factoryUserOrgId(user);\n    const actorProfile = auditActorProfile(user);\n    if (userId && orgId) caller = { orgId, userId, ...(actorProfile ? { actorProfile } : {}) };\n  } else {\n    caller = { orgId: 'local', userId: 'local' };\n  }\n\n  const row = await sessions.getBySessionId(resourceId);\n  if (!row?.factoryProjectId) return null;\n  // A caller from another org never acts here, worker or not.\n  if (caller && row.orgId !== caller.orgId) return null;\n\n  // A side session works for the session that started it. Otherwise any\n  // binding, active or revoked, on any thread: a session that ever ran a role stays a worker.\n  const origin =\n    row.originSessionId && row.originThreadId\n      ? { sessionId: row.originSessionId, threadId: row.originThreadId }\n      : undefined;\n  const worker =\n    origin !== undefined ||\n    (await workItems.hasRunBindingForSession({\n      orgId: row.orgId,\n      factoryProjectId: row.factoryProjectId,\n      sessionId: row.sessionId,\n    }));\n\n  // A worker acts as its session row: dispatcher-driven runs carry no signed-in user.\n  // A user session acts as the signed-in caller, who must be able to see it.\n  let identity: { orgId: string; userId: string; actorProfile?: AuditActorProfileInput };\n  if (worker) {\n    identity = { orgId: row.orgId, userId: row.userId };\n  } else {\n    if (!caller) return null;\n    if (row.visibility === 'private' && row.userId !== caller.userId) return null;\n    identity = caller;\n  }\n\n  const project = await projects.get({ orgId: identity.orgId, id: row.factoryProjectId });\n  if (!project) return null;\n\n  return {\n    orgId: identity.orgId,\n    factoryProjectId: row.factoryProjectId,\n    userId: identity.userId,\n    sessionId: row.sessionId,\n    resourceId,\n    threadId,\n    kind: worker ? 'worker' : 'user',\n    interactive: requestContext.get(FACTORY_INTERACTIVE_KEY) === true,\n    ...(identity.actorProfile ? { actorProfile: identity.actorProfile } : {}),\n    ...(origin ? { origin } : {}),\n  };\n}\n"],"mappings":";;;;;;;;;AAoDA,eAAsB,wBAAwB,EAC5C,gBACA,aACA,UACA,UACA,aACmE;CACnE,IAAI,OAAO,gBAAgB,QAAQ,YAAY,OAAO;CACtD,MAAM,aAAa,eAAe,IAAI,YAAY;CAClD,MAAM,aAAa,YAAY;CAC/B,MAAM,WAAW,YAAY;CAC7B,IAAI,CAAC,cAAc,CAAC,UAAU,OAAO;CAErC,IAAI,SAA0F;CAC9F,IAAI,aAAa;EACf,MAAM,OAAO,8BAA8B,cAAc;EACzD,MAAM,SAAS,qBAAqB,IAAI;EACxC,MAAM,QAAQ,iBAAiB,IAAI;EACnC,MAAM,eAAe,kBAAkB,IAAI;EAC3C,IAAI,UAAU,OAAO,SAAS;GAAE;GAAO;GAAQ,GAAI,eAAe,EAAE,aAAa,IAAI,CAAC;EAAG;CAC3F,OACE,SAAS;EAAE,OAAO;EAAS,QAAQ;CAAQ;CAG7C,MAAM,MAAM,MAAM,SAAS,eAAe,UAAU;CACpD,IAAI,CAAC,KAAK,kBAAkB,OAAO;CAEnC,IAAI,UAAU,IAAI,UAAU,OAAO,OAAO,OAAO;CAIjD,MAAM,SACJ,IAAI,mBAAmB,IAAI,iBACvB;EAAE,WAAW,IAAI;EAAiB,UAAU,IAAI;CAAe,IAC/D,KAAA;CACN,MAAM,SACJ,WAAW,KAAA,KACV,MAAM,UAAU,wBAAwB;EACvC,OAAO,IAAI;EACX,kBAAkB,IAAI;EACtB,WAAW,IAAI;CACjB,CAAC;CAIH,IAAI;CACJ,IAAI,QACF,WAAW;EAAE,OAAO,IAAI;EAAO,QAAQ,IAAI;CAAO;MAC7C;EACL,IAAI,CAAC,QAAQ,OAAO;EACpB,IAAI,IAAI,eAAe,aAAa,IAAI,WAAW,OAAO,QAAQ,OAAO;EACzE,WAAW;CACb;CAGA,IAAI,CAAC,MADiB,SAAS,IAAI;EAAE,OAAO,SAAS;EAAO,IAAI,IAAI;CAAiB,CAAC,GACxE,OAAO;CAErB,OAAO;EACL,OAAO,SAAS;EAChB,kBAAkB,IAAI;EACtB,QAAQ,SAAS;EACjB,WAAW,IAAI;EACf;EACA;EACA,MAAM,SAAS,WAAW;EAC1B,aAAa,eAAe,IAAI,uBAAuB,MAAM;EAC7D,GAAI,SAAS,eAAe,EAAE,cAAc,SAAS,aAAa,IAAI,CAAC;EACvE,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;CAC7B;AACF"}

package/dist/tools/session-tools.d.ts

@@ -0,0 +1,31 @@
+import type { BoardRegistry } from '../boards/registry.js';
+import type { IntegrationTools } from '../integrations/base.js';
+import { type FactoryStartCoordinator } from '../rules/start-coordinator.js';
+import type { SourceControlSessionLookup } from '../session/factory-session.js';
+import type { AuditRecorder } from '../storage/domains/audit/domain.js';
+import type { IntakeStorage } from '../storage/domains/intake/base.js';
+import type { ModelDefaultsStorage } from '../storage/domains/model-defaults/base.js';
+import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
+import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
+import type { FactoryMessaging } from './messaging-tools.js';
+import type { FactoryToolScope } from './scope.js';
+/** Who renews the open-run entries this process writes; one id per process, like the dispatcher's. */
+export declare const FACTORY_TOOLS_OWNER_ID: string;
+export interface FactorySessionToolDependencies {
+    sessions: Pick<SourceControlSessionLookup, 'getBySessionId' | 'getSourceControlBySessionId'>;
+    sessionModel: {
+        projects: FactoryProjectsStorage;
+        modelDefaults: ModelDefaultsStorage;
+    };
+    /** Resolved lazily: the controller only exists once the mount is up. */
+    messaging: () => Promise<FactoryMessaging | null>;
+    workItems: Pick<WorkItemsStorage, 'list' | 'getForProject' | 'listRunBindings' | 'subscribeToWorkItem' | 'unsubscribeFromWorkItem' | 'listSessionSubscriptions' | 'listWorkItemSubscribers'>;
+    boards: BoardRegistry;
+    auditRecorder: AuditRecorder;
+    intake?: Pick<IntakeStorage, 'getConfig'>;
+    /** The browser Start's coordinator; absent until the Factory runtime is ready. */
+    startCoordinator: () => Pick<FactoryStartCoordinator, 'prepare'> | undefined;
+}
+/** Tools that start sessions on the caller's behalf. Interactive user turns only. */
+export declare function createFactorySessionTools(scope: FactoryToolScope, deps: FactorySessionToolDependencies): IntegrationTools;
+//# sourceMappingURL=session-tools.d.ts.map

package/dist/tools/session-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tools.d.ts","sourceRoot":"","sources":["../../src/tools/session-tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAQhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,sGAAsG;AACtG,eAAO,MAAM,sBAAsB,QAAoD,CAAC;AAExF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,GAAG,6BAA6B,CAAC,CAAC;IAC7F,YAAY,EAAE;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,aAAa,EAAE,oBAAoB,CAAA;KAAE,CAAC;IACxF,wEAAwE;IACxE,SAAS,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAClD,SAAS,EAAE,IAAI,CACb,gBAAgB,EACd,MAAM,GACN,eAAe,GACf,iBAAiB,GACjB,qBAAqB,GACrB,yBAAyB,GACzB,0BAA0B,GAC1B,yBAAyB,CAC5B,CAAC;IACF,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC1C,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC;CAC9E;AAwBD,qFAAqF;AACrF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,8BAA8B,GACnC,gBAAgB,CAuRlB"}

package/dist/tools/session-tools.js

@@ -0,0 +1,312 @@
+import { boardForWorkItem } from "../boards/semantics.js";
+import "../boards/index.js";
+import { primeTenantCredentialsForTenant } from "../routes/tenant-credentials.js";
+import { effectiveModelScope } from "../storage/domains/projects/base.js";
+import { ensureFactorySourceSession, hydrateFactorySession, resolveFactorySessionModel } from "../session/factory-session.js";
+import "./deliver.js";
+import { findWorkItem, workItemNotFound, workItemNumber, workItemRefSchema } from "./read-tools.js";
+import { USER_SESSION_BRANCH_PREFIX } from "../routes/source-control-sessions.js";
+import { resolveWorkItemRepository } from "../session/work-item-repository.js";
+import { FactoryStartTransitionError, WorkItemRepositoryError } from "../rules/start-coordinator.js";
+import { recordSessionRunStart } from "../session/run-audit.js";
+import { heartbeatOpenRunUntilEnd } from "./run-watch.js";
+import { RequestContext } from "@mastra/core/request-context";
+import { z } from "zod";
+import { createTool } from "@mastra/core/tools";
+//#region src/tools/session-tools.ts
+const TITLE_LENGTH = 120;
+/** Who renews the open-run entries this process writes; one id per process, like the dispatcher's. */
+const FACTORY_TOOLS_OWNER_ID = `factory-tools:${globalThis.crypto.randomUUID()}`;
+function ambiguousRepository(candidates) {
+	return `This item has several repositories (${candidates.join(", ")}); v1 can't choose one.`;
+}
+function startErrorMessage(error) {
+	if (error instanceof WorkItemRepositoryError) return error.code === "repository_ambiguous" ? ambiguousRepository(error.candidates) : error.message;
+	if (error instanceof FactoryStartTransitionError) return `The start was refused: ${error.result.reason}`;
+	return null;
+}
+function workItemLabel(item) {
+	const number = workItemNumber(item);
+	return number === null ? `"${item.title}"` : `#${number}`;
+}
+function titleFrom(prompt) {
+	return (prompt.split("\n").find((line) => line.trim()) ?? prompt).trim().slice(0, TITLE_LENGTH);
+}
+/** Tools that start sessions on the caller's behalf. Interactive user turns only. */
+function createFactorySessionTools(scope, deps) {
+	const start = createTool({
+		id: "factory_start_session",
+		description: [
+			"Start a side session in this Factory with a prompt. It runs on its own sandbox and branch as you, and reports back to this session with `factory-session` notifications.",
+			"Use it for self-contained investigations; when the result should land as a pull request, file a work item instead.",
+			"With `workItem` and `role` it starts that role on the work item instead, without moving the card, and this session follows the item.",
+			"A role that already has a session on the item (current or past) can't be started again from here: message that session with factory_signal_session, or ask the person to use the board."
+		].join(" "),
+		inputSchema: z.object({
+			prompt: z.string().trim().min(1).max(8e3).describe("The first message the new session receives."),
+			title: z.string().trim().min(1).max(TITLE_LENGTH).optional(),
+			workItem: workItemRefSchema.optional(),
+			role: z.string().trim().min(1).max(64).optional()
+		}).strict().refine((input) => input.role === void 0 || input.workItem !== void 0, {
+			message: "Pass workItem together with role.",
+			path: ["role"]
+		}),
+		execute: async ({ prompt, title, workItem, role }) => {
+			if (workItem !== void 0) return startWorkItemRole({
+				prompt,
+				title,
+				workItem,
+				role
+			});
+			const parent = await deps.sessions.getBySessionId(scope.sessionId);
+			const sourceControl = await deps.sessions.getSourceControlBySessionId(scope.sessionId);
+			if (!parent || !sourceControl) throw new Error("This session has no Factory session row to start from.");
+			const messaging = await deps.messaging();
+			if (!messaging) throw new Error("Starting sessions is not available on this server.");
+			const sessionId = globalThis.crypto.randomUUID();
+			const ensured = await ensureFactorySourceSession({
+				sourceControl,
+				orgId: scope.orgId,
+				factoryProjectId: scope.factoryProjectId,
+				sessionId,
+				branch: `${USER_SESSION_BRANCH_PREFIX}${sessionId}`,
+				attributeToUserId: scope.userId,
+				...parent.projectRepositoryId ? { projectRepositoryId: parent.projectRepositoryId } : {},
+				visibility: parent.visibility,
+				origin: {
+					sessionId: scope.sessionId,
+					threadId: scope.threadId
+				}
+			});
+			const sessionModel = await resolveFactorySessionModel({
+				...deps.sessionModel,
+				factoryProjectId: scope.factoryProjectId,
+				orgId: scope.orgId,
+				ownerUserId: scope.userId,
+				context: "session"
+			});
+			const kickoffContext = new RequestContext();
+			kickoffContext.set("user", {
+				workosId: scope.userId,
+				organizationId: scope.orgId
+			});
+			const tags = {
+				factoryProjectId: scope.factoryProjectId,
+				projectRepositoryId: ensured.projectRepositoryId
+			};
+			const session = await messaging.controller.createSession({
+				id: ensured.sessionId,
+				ownerId: scope.userId,
+				resourceId: ensured.sessionId,
+				threadId: ensured.sessionId,
+				requestContext: kickoffContext,
+				tags
+			});
+			await session.state.set(tags);
+			await hydrateFactorySession(session, {
+				orgId: scope.orgId,
+				modelScope: sessionModel.modelScope,
+				ownerUserId: scope.userId,
+				defaultModelId: sessionModel.modelId
+			});
+			const threadId = session.thread.requireId();
+			const threadTitle = title ?? titleFrom(prompt);
+			await session.thread.rename({
+				title: threadTitle,
+				pin: false
+			});
+			await sourceControl.sessions.rename({
+				sessionId: ensured.sessionId,
+				title: threadTitle
+			});
+			await session.thread.setSetting({
+				key: "factorySessionId",
+				value: ensured.sessionId
+			});
+			await primeTenantCredentialsForTenant({
+				orgId: scope.orgId,
+				userId: scope.userId,
+				credentialScope: sessionModel.modelScope
+			});
+			await session.sendSignal({
+				id: globalThis.crypto.randomUUID(),
+				type: "user",
+				tagName: "user",
+				contents: prompt
+			}, {
+				requestContext: kickoffContext,
+				requireDelivery: true
+			}).accepted;
+			return {
+				mode: "side",
+				sessionId: ensured.sessionId,
+				threadId,
+				title: threadTitle
+			};
+		}
+	});
+	async function startWorkItemRole({ prompt, title, workItem, role }) {
+		if (!role) throw new Error("Pass the role to start on the work item.");
+		const coordinator = deps.startCoordinator();
+		if (!coordinator) throw new Error("Factory sessions can't be started yet; try again shortly.");
+		const item = await findWorkItem(deps.workItems, scope, workItem);
+		if (!item) throw workItemNotFound(workItem);
+		const label = workItemLabel(item);
+		if (!deps.boards.get(boardForWorkItem(item))?.phaseForRole(role)) throw new Error(`${label}'s board has no ${role} role.`);
+		const seated = item.sessions[role];
+		if (seated) throw new Error(`${label} already has a ${role} session ${seated.sessionId}; message it with factory_signal_session.`);
+		const parent = await deps.sessions.getBySessionId(scope.sessionId);
+		const sourceControl = await deps.sessions.getSourceControlBySessionId(scope.sessionId);
+		if (!parent || !sourceControl) throw new Error("This session has no Factory session row to start from.");
+		const messaging = await deps.messaging();
+		if (!messaging) throw new Error("Starting sessions is not available on this server.");
+		const project = await deps.sessionModel.projects.get({
+			orgId: scope.orgId,
+			id: scope.factoryProjectId
+		});
+		if (!project) throw new Error("This Factory no longer exists.");
+		const modelScope = effectiveModelScope(project.modelScope, "run");
+		const projectRepositoryId = await resolveRepository(sourceControl, item);
+		const sessionId = globalThis.crypto.randomUUID();
+		const ensured = await ensureFactorySourceSession({
+			sourceControl,
+			orgId: scope.orgId,
+			factoryProjectId: scope.factoryProjectId,
+			sessionId,
+			branch: `${USER_SESSION_BRANCH_PREFIX}${sessionId}`,
+			projectRepositoryId,
+			attributeToUserId: scope.userId,
+			visibility: parent.visibility
+		});
+		const followScope = {
+			orgId: scope.orgId,
+			factoryProjectId: scope.factoryProjectId
+		};
+		const alreadyFollowing = (await deps.workItems.listSessionSubscriptions({
+			...followScope,
+			sessionId: scope.sessionId
+		})).some((subscription) => subscription.workItemId === item.id);
+		await deps.workItems.subscribeToWorkItem({
+			...followScope,
+			workItemId: item.id,
+			sessionId: scope.sessionId,
+			threadId: scope.threadId,
+			resourceId: scope.resourceId,
+			userId: scope.userId,
+			reason: "started"
+		});
+		const startedAt = /* @__PURE__ */ new Date();
+		let prepared;
+		try {
+			prepared = await coordinator.prepare({
+				orgId: scope.orgId,
+				userId: scope.userId,
+				factoryProjectId: scope.factoryProjectId,
+				sessionId: ensured.sessionId,
+				threadTitle: title ?? `${label} ${role}`,
+				kickoffKey: globalThis.crypto.randomUUID(),
+				modelScope,
+				defaultModelId: modelScope === "factory" ? project.defaultModelId ?? void 0 : void 0,
+				workItem: {
+					id: item.id,
+					role,
+					input: {
+						externalSource: item.externalSource,
+						parentWorkItemId: item.parentWorkItemId,
+						title: item.title,
+						stages: item.stages,
+						sessions: item.sessions,
+						metadata: item.metadata
+					}
+				}
+			});
+		} catch (error) {
+			if (!alreadyFollowing) await deps.workItems.unsubscribeFromWorkItem({
+				orgId: scope.orgId,
+				workItemId: item.id,
+				sessionId: scope.sessionId
+			});
+			const message = startErrorMessage(error);
+			if (message) throw new Error(message);
+			throw error;
+		}
+		const replaced = (await deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id)).find((binding) => binding.role === role && binding.id !== prepared.bindingId && binding.revokedAt !== null && binding.revokedAt >= startedAt);
+		const session = await messaging.controller.getSessionByResource(prepared.resourceId);
+		if (!session) throw new Error(`The ${role} session was bound but is not running; open it from the board.`);
+		const kickoffId = globalThis.crypto.randomUUID();
+		const heartbeat = heartbeatOpenRunUntilEnd(session, kickoffId);
+		const kickoffContext = new RequestContext();
+		kickoffContext.set("user", {
+			workosId: scope.userId,
+			organizationId: scope.orgId
+		});
+		try {
+			await session.sendSignal({
+				id: kickoffId,
+				type: "user",
+				tagName: "user",
+				contents: prompt
+			}, {
+				requestContext: kickoffContext,
+				requireDelivery: true
+			}).accepted;
+		} catch (error) {
+			heartbeat.stop();
+			throw error;
+		}
+		await recordSessionRunStart(session, {
+			audit: deps.auditRecorder,
+			actorType: "human",
+			observedEnd: heartbeat.endReason,
+			run: {
+				kickoffId,
+				ownerId: FACTORY_TOOLS_OWNER_ID,
+				heartbeatAt: Date.now(),
+				bindingId: prepared.bindingId,
+				role,
+				startedBy: scope.userId,
+				orgId: scope.orgId,
+				factoryProjectId: scope.factoryProjectId,
+				workItemId: item.id,
+				workItemName: item.title,
+				sessionId: prepared.sessionId,
+				threadId: prepared.threadId,
+				branch: prepared.branch
+			}
+		});
+		const number = workItemNumber(item);
+		return {
+			mode: "work-item",
+			workItem: {
+				id: item.id,
+				...number === null ? {} : { number }
+			},
+			role,
+			sessionId: prepared.sessionId,
+			threadId: prepared.threadId,
+			bindingId: prepared.bindingId,
+			...replaced ? { replacedSessionId: replaced.sessionId } : {}
+		};
+	}
+	async function resolveRepository(sourceControl, item) {
+		const intakeConfig = await deps.intake?.getConfig({
+			orgId: scope.orgId,
+			integrationIds: ["linear"]
+		});
+		const repository = await resolveWorkItemRepository({
+			sourceControl,
+			orgId: scope.orgId,
+			factoryProjectId: scope.factoryProjectId,
+			item,
+			linearRepositoryMap: intakeConfig?.linear?.repositoryByLinearProject
+		});
+		if (repository.status === "ambiguous") throw new Error(ambiguousRepository(repository.candidates));
+		if (repository.status === "unlinked") throw new Error(repository.hint);
+		return repository.projectRepositoryId;
+	}
+	return { factory_start_session: start };
+}
+//#endregion
+export { FACTORY_TOOLS_OWNER_ID, createFactorySessionTools };
+
+//# sourceMappingURL=session-tools.js.map

package/dist/tools/session-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tools.js","names":[],"sources":["../../src/tools/session-tools.ts"],"sourcesContent":["import { RequestContext } from '@mastra/core/request-context';\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { boardForWorkItem } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/registry.js';\nimport type { IntegrationTools } from '../integrations/base.js';\nimport { USER_SESSION_BRANCH_PREFIX } from '../routes/source-control-sessions.js';\nimport { primeTenantCredentialsForTenant } from '../routes/tenant-credentials.js';\nimport {\n  FactoryStartTransitionError,\n  WorkItemRepositoryError,\n  type FactoryStartCoordinator,\n} from '../rules/start-coordinator.js';\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport {\n  ensureFactorySourceSession,\n  hydrateFactorySession,\n  resolveFactorySessionModel,\n} from '../session/factory-session.js';\nimport { recordSessionRunStart } from '../session/run-audit.js';\nimport { resolveWorkItemRepository } from '../session/work-item-repository.js';\nimport type { AuditRecorder } from '../storage/domains/audit/domain.js';\nimport type { IntakeStorage } from '../storage/domains/intake/base.js';\nimport type { ModelDefaultsStorage } from '../storage/domains/model-defaults/base.js';\nimport { effectiveModelScope } from '../storage/domains/projects/base.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { SourceControlStorageHandle } from '../storage/domains/source-control/base.js';\nimport type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { deliverFactorySessionNotification } from './deliver.js';\nimport type { FactoryMessaging } from './messaging-tools.js';\nimport { findWorkItem, workItemNotFound, workItemNumber, workItemRefSchema } from './read-tools.js';\nimport { heartbeatOpenRunUntilEnd } from './run-watch.js';\nimport type { FactoryToolScope } from './scope.js';\n\nconst TITLE_LENGTH = 120;\n\n/** Who renews the open-run entries this process writes; one id per process, like the dispatcher's. */\nexport const FACTORY_TOOLS_OWNER_ID = `factory-tools:${globalThis.crypto.randomUUID()}`;\n\nexport interface FactorySessionToolDependencies {\n  sessions: Pick<SourceControlSessionLookup, 'getBySessionId' | 'getSourceControlBySessionId'>;\n  sessionModel: { projects: FactoryProjectsStorage; modelDefaults: ModelDefaultsStorage };\n  /** Resolved lazily: the controller only exists once the mount is up. */\n  messaging: () => Promise<FactoryMessaging | null>;\n  workItems: Pick<\n    WorkItemsStorage,\n    | 'list'\n    | 'getForProject'\n    | 'listRunBindings'\n    | 'subscribeToWorkItem'\n    | 'unsubscribeFromWorkItem'\n    | 'listSessionSubscriptions'\n    | 'listWorkItemSubscribers'\n  >;\n  boards: BoardRegistry;\n  auditRecorder: AuditRecorder;\n  intake?: Pick<IntakeStorage, 'getConfig'>;\n  /** The browser Start's coordinator; absent until the Factory runtime is ready. */\n  startCoordinator: () => Pick<FactoryStartCoordinator, 'prepare'> | undefined;\n}\n\nfunction ambiguousRepository(candidates: readonly string[]): string {\n  return `This item has several repositories (${candidates.join(', ')}); v1 can't choose one.`;\n}\n\nfunction startErrorMessage(error: unknown): string | null {\n  if (error instanceof WorkItemRepositoryError) {\n    return error.code === 'repository_ambiguous' ? ambiguousRepository(error.candidates) : error.message;\n  }\n  if (error instanceof FactoryStartTransitionError) return `The start was refused: ${error.result.reason}`;\n  return null;\n}\n\nfunction workItemLabel(item: WorkItemRow): string {\n  const number = workItemNumber(item);\n  return number === null ? `\"${item.title}\"` : `#${number}`;\n}\n\nfunction titleFrom(prompt: string): string {\n  const firstLine = prompt.split('\\n').find(line => line.trim()) ?? prompt;\n  return firstLine.trim().slice(0, TITLE_LENGTH);\n}\n\n/** Tools that start sessions on the caller's behalf. Interactive user turns only. */\nexport function createFactorySessionTools(\n  scope: FactoryToolScope,\n  deps: FactorySessionToolDependencies,\n): IntegrationTools {\n  const start = createTool({\n    id: 'factory_start_session',\n    description: [\n      'Start a side session in this Factory with a prompt. It runs on its own sandbox and branch as you, and reports back to this session with `factory-session` notifications.',\n      'Use it for self-contained investigations; when the result should land as a pull request, file a work item instead.',\n      'With `workItem` and `role` it starts that role on the work item instead, without moving the card, and this session follows the item.',\n      \"A role that already has a session on the item (current or past) can't be started again from here: message that session with factory_signal_session, or ask the person to use the board.\",\n    ].join(' '),\n    inputSchema: z\n      .object({\n        prompt: z.string().trim().min(1).max(8000).describe('The first message the new session receives.'),\n        title: z.string().trim().min(1).max(TITLE_LENGTH).optional(),\n        workItem: workItemRefSchema.optional(),\n        role: z.string().trim().min(1).max(64).optional(),\n      })\n      .strict()\n      .refine(input => input.role === undefined || input.workItem !== undefined, {\n        message: 'Pass workItem together with role.',\n        path: ['role'],\n      }),\n    execute: async ({ prompt, title, workItem, role }) => {\n      if (workItem !== undefined) return startWorkItemRole({ prompt, title, workItem, role });\n\n      const parent = await deps.sessions.getBySessionId(scope.sessionId);\n      const sourceControl = await deps.sessions.getSourceControlBySessionId(scope.sessionId);\n      if (!parent || !sourceControl) throw new Error('This session has no Factory session row to start from.');\n      const messaging = await deps.messaging();\n      if (!messaging) throw new Error('Starting sessions is not available on this server.');\n\n      const sessionId = globalThis.crypto.randomUUID();\n      const ensured = await ensureFactorySourceSession({\n        sourceControl,\n        orgId: scope.orgId,\n        factoryProjectId: scope.factoryProjectId,\n        sessionId,\n        branch: `${USER_SESSION_BRANCH_PREFIX}${sessionId}`,\n        // Bills the caller: the credential tenant follows the row's user.\n        attributeToUserId: scope.userId,\n        // Same repository as the session that started it.\n        ...(parent.projectRepositoryId ? { projectRepositoryId: parent.projectRepositoryId } : {}),\n        visibility: parent.visibility,\n        origin: { sessionId: scope.sessionId, threadId: scope.threadId },\n      });\n      const sessionModel = await resolveFactorySessionModel({\n        ...deps.sessionModel,\n        factoryProjectId: scope.factoryProjectId,\n        orgId: scope.orgId,\n        ownerUserId: scope.userId,\n        // No work item, so an interactive session: a hybrid Factory bills it as one.\n        context: 'session',\n      });\n\n      // Only the new row's owner as `user`. The tool call's context carries the\n      // interactive marker and the parent's controller entry; neither may reach the child.\n      const kickoffContext = new RequestContext();\n      kickoffContext.set('user', { workosId: scope.userId, organizationId: scope.orgId });\n\n      const tags = { factoryProjectId: scope.factoryProjectId, projectRepositoryId: ensured.projectRepositoryId };\n      const session = await messaging.controller.createSession({\n        id: ensured.sessionId,\n        ownerId: scope.userId,\n        resourceId: ensured.sessionId,\n        threadId: ensured.sessionId,\n        requestContext: kickoffContext,\n        tags,\n      });\n      await session.state.set(tags);\n      await hydrateFactorySession(session, {\n        orgId: scope.orgId,\n        modelScope: sessionModel.modelScope,\n        ownerUserId: scope.userId,\n        defaultModelId: sessionModel.modelId,\n      });\n\n      const threadId = session.thread.requireId();\n      const threadTitle = title ?? titleFrom(prompt);\n      await session.thread.rename({ title: threadTitle, pin: false });\n      // On the row too, so its run-end reports name it without waiting for the title mirror.\n      await sourceControl.sessions.rename({ sessionId: ensured.sessionId, title: threadTitle });\n      await session.thread.setSetting({ key: 'factorySessionId', value: ensured.sessionId });\n\n      await primeTenantCredentialsForTenant({\n        orgId: scope.orgId,\n        userId: scope.userId,\n        credentialScope: sessionModel.modelScope,\n      });\n      // How its runs end reaches this session through the listener every Factory\n      // session gets (`observeSessionRunReports`), which follows the row's origin.\n      // `requireDelivery` makes `accepted` reject when the wake fails; the run itself is not awaited.\n      await session.sendSignal(\n        { id: globalThis.crypto.randomUUID(), type: 'user', tagName: 'user', contents: prompt },\n        { requestContext: kickoffContext, requireDelivery: true },\n      ).accepted;\n\n      return { mode: 'side' as const, sessionId: ensured.sessionId, threadId, title: threadTitle };\n    },\n  });\n\n  async function startWorkItemRole({\n    prompt,\n    title,\n    workItem,\n    role,\n  }: {\n    prompt: string;\n    title?: string;\n    workItem: string;\n    role?: string;\n  }) {\n    if (!role) throw new Error('Pass the role to start on the work item.');\n    const coordinator = deps.startCoordinator();\n    if (!coordinator) throw new Error(\"Factory sessions can't be started yet; try again shortly.\");\n    const item = await findWorkItem(deps.workItems, scope, workItem);\n    if (!item) throw workItemNotFound(workItem);\n    const label = workItemLabel(item);\n    const board = deps.boards.get(boardForWorkItem(item));\n    if (!board?.phaseForRole(role)) throw new Error(`${label}'s board has no ${role} role.`);\n    const seated = item.sessions[role];\n    if (seated) {\n      throw new Error(\n        `${label} already has a ${role} session ${seated.sessionId}; message it with factory_signal_session.`,\n      );\n    }\n\n    const parent = await deps.sessions.getBySessionId(scope.sessionId);\n    const sourceControl = await deps.sessions.getSourceControlBySessionId(scope.sessionId);\n    if (!parent || !sourceControl) throw new Error('This session has no Factory session row to start from.');\n    const messaging = await deps.messaging();\n    if (!messaging) throw new Error('Starting sessions is not available on this server.');\n    const project = await deps.sessionModel.projects.get({ orgId: scope.orgId, id: scope.factoryProjectId });\n    if (!project) throw new Error('This Factory no longer exists.');\n    // A work-item start is a run, so a hybrid Factory uses the Factory's scope (as the Start route does).\n    const modelScope = effectiveModelScope(project.modelScope, 'run');\n    const projectRepositoryId = await resolveRepository(sourceControl, item);\n\n    const sessionId = globalThis.crypto.randomUUID();\n    const ensured = await ensureFactorySourceSession({\n      sourceControl,\n      orgId: scope.orgId,\n      factoryProjectId: scope.factoryProjectId,\n      sessionId,\n      branch: `${USER_SESSION_BRANCH_PREFIX}${sessionId}`,\n      projectRepositoryId,\n      attributeToUserId: scope.userId,\n      visibility: parent.visibility,\n    });\n\n    // Follow first, so a fast run's first report already has somewhere to go.\n    const followScope = { orgId: scope.orgId, factoryProjectId: scope.factoryProjectId };\n    const alreadyFollowing = (\n      await deps.workItems.listSessionSubscriptions({ ...followScope, sessionId: scope.sessionId })\n    ).some(subscription => subscription.workItemId === item.id);\n    await deps.workItems.subscribeToWorkItem({\n      ...followScope,\n      workItemId: item.id,\n      sessionId: scope.sessionId,\n      threadId: scope.threadId,\n      resourceId: scope.resourceId,\n      userId: scope.userId,\n      reason: 'started',\n    });\n\n    const startedAt = new Date();\n    let prepared;\n    try {\n      prepared = await coordinator.prepare({\n        orgId: scope.orgId,\n        userId: scope.userId,\n        factoryProjectId: scope.factoryProjectId,\n        sessionId: ensured.sessionId,\n        threadTitle: title ?? `${label} ${role}`,\n        kickoffKey: globalThis.crypto.randomUUID(),\n        modelScope,\n        defaultModelId: modelScope === 'factory' ? (project.defaultModelId ?? undefined) : undefined,\n        workItem: {\n          id: item.id,\n          role,\n          input: {\n            externalSource: item.externalSource,\n            parentWorkItemId: item.parentWorkItemId,\n            title: item.title,\n            stages: item.stages,\n            sessions: item.sessions,\n            metadata: item.metadata,\n          },\n        },\n      });\n    } catch (error) {\n      if (!alreadyFollowing) {\n        await deps.workItems.unsubscribeFromWorkItem({\n          orgId: scope.orgId,\n          workItemId: item.id,\n          sessionId: scope.sessionId,\n        });\n      }\n      const message = startErrorMessage(error);\n      if (message) throw new Error(message);\n      throw error;\n    }\n\n    const bindings = await deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id);\n    const replaced = bindings.find(\n      binding =>\n        binding.role === role &&\n        binding.id !== prepared.bindingId &&\n        binding.revokedAt !== null &&\n        binding.revokedAt >= startedAt,\n    );\n\n    const session = await messaging.controller.getSessionByResource(prepared.resourceId);\n    if (!session) throw new Error(`The ${role} session was bound but is not running; open it from the board.`);\n    const kickoffId = globalThis.crypto.randomUUID();\n    // Heartbeat from before the kickoff so a fast run's end is seen; the open-run\n    // entry and audit follow the accepted kickoff, as the dispatcher records them.\n    // The run's end reaches this item's followers through the session's listener.\n    const heartbeat = heartbeatOpenRunUntilEnd(session, kickoffId);\n    const kickoffContext = new RequestContext();\n    kickoffContext.set('user', { workosId: scope.userId, organizationId: scope.orgId });\n    try {\n      await session.sendSignal(\n        { id: kickoffId, type: 'user', tagName: 'user', contents: prompt },\n        { requestContext: kickoffContext, requireDelivery: true },\n      ).accepted;\n    } catch (error) {\n      heartbeat.stop();\n      throw error;\n    }\n\n    await recordSessionRunStart(session, {\n      audit: deps.auditRecorder,\n      actorType: 'human',\n      observedEnd: heartbeat.endReason,\n      run: {\n        kickoffId,\n        ownerId: FACTORY_TOOLS_OWNER_ID,\n        heartbeatAt: Date.now(),\n        bindingId: prepared.bindingId,\n        role,\n        startedBy: scope.userId,\n        orgId: scope.orgId,\n        factoryProjectId: scope.factoryProjectId,\n        workItemId: item.id,\n        workItemName: item.title,\n        sessionId: prepared.sessionId,\n        threadId: prepared.threadId,\n        branch: prepared.branch,\n      },\n    });\n\n    const number = workItemNumber(item);\n    return {\n      mode: 'work-item' as const,\n      workItem: { id: item.id, ...(number === null ? {} : { number }) },\n      role,\n      sessionId: prepared.sessionId,\n      threadId: prepared.threadId,\n      bindingId: prepared.bindingId,\n      ...(replaced ? { replacedSessionId: replaced.sessionId } : {}),\n    };\n  }\n\n  async function resolveRepository(sourceControl: SourceControlStorageHandle, item: WorkItemRow): Promise<string> {\n    const intakeConfig = await deps.intake?.getConfig({ orgId: scope.orgId, integrationIds: ['linear'] });\n    const repository = await resolveWorkItemRepository({\n      sourceControl,\n      orgId: scope.orgId,\n      factoryProjectId: scope.factoryProjectId,\n      item,\n      linearRepositoryMap: intakeConfig?.linear?.repositoryByLinearProject,\n    });\n    if (repository.status === 'ambiguous') {\n      throw new Error(ambiguousRepository(repository.candidates));\n    }\n    if (repository.status === 'unlinked') throw new Error(repository.hint);\n    return repository.projectRepositoryId;\n  }\n\n  return { factory_start_session: start };\n}\n"],"mappings":"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"}

package/dist/tools/sessions-state-processor.d.ts

@@ -0,0 +1,37 @@
+import type { NotificationsStorage } from '@mastra/core/notifications';
+import type { ComputeStateSignalArgs, ComputeStateSignalResult, Processor } from '@mastra/core/processors';
+import type { BoardRegistry } from '../boards/registry.js';
+import type { SourceControlSessionLookup } from '../session/factory-session.js';
+import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
+import type { ResolveFactoryToolScopeOptions } from './scope.js';
+/** Finished side sessions and items that reached a terminal stage drop out after this long. */
+export declare const FACTORY_SESSIONS_MAX_AGE_MS: number;
+/** Rows shown before the rest collapse into "+N more". */
+export declare const FACTORY_SESSIONS_MAX_ROWS = 20;
+export type FactorySessionRunState = 'running' | 'idle' | 'parked';
+export interface FactorySessionsStateDependencies {
+    authEnabled: boolean;
+    sessions: Pick<SourceControlSessionLookup, 'getBySessionId' | 'listByOrigin'>;
+    projects: ResolveFactoryToolScopeOptions['projects'];
+    workItems: Pick<WorkItemsStorage, 'hasRunBindingForSession' | 'listSessionSubscriptions' | 'getForProject' | 'listRunBindings' | 'findActiveRunBindingForSession' | 'listWorkItemSubscribers'>;
+    boards: BoardRegistry;
+    /** Whether the session's agent is mid-run in this process; `idle` when it isn't live here. */
+    isRunning: (sessionId: string) => Promise<boolean>;
+    notifications: () => Promise<Pick<NotificationsStorage, 'listNotifications'> | null>;
+    now?: () => number;
+}
+/**
+ * The `<factory-sessions>` state signal. A user session sees the side sessions
+ * it started and the work items it follows; a side session or item worker sees
+ * who it reports to. Sessions it only messaged never appear. Silent until there
+ * is something to show; when the last entry ages out it sends one final empty
+ * snapshot, then stays silent.
+ */
+export declare class FactorySessionsStateProcessor implements Processor<'factory-sessions'> {
+    #private;
+    readonly id = "factory-sessions";
+    readonly stateId = "factory-sessions";
+    constructor(deps: FactorySessionsStateDependencies);
+    computeStateSignal(args: ComputeStateSignalArgs): Promise<ComputeStateSignalResult>;
+}
+//# sourceMappingURL=sessions-state-processor.d.ts.map

package/dist/tools/sessions-state-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-state-processor.d.ts","sourceRoot":"","sources":["../../src/tools/sessions-state-processor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAG3G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAI3F,OAAO,KAAK,EAAoB,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAGnF,+FAA+F;AAC/F,eAAO,MAAM,2BAA2B,QAAsB,CAAC;AAC/D,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAI5C,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,GAAG,cAAc,CAAC,CAAC;IAC9E,QAAQ,EAAE,8BAA8B,CAAC,UAAU,CAAC,CAAC;IACrD,SAAS,EAAE,IAAI,CACb,gBAAgB,EACd,yBAAyB,GACzB,0BAA0B,GAC1B,eAAe,GACf,iBAAiB,GACjB,gCAAgC,GAChC,yBAAyB,CAC5B,CAAC;IACF,MAAM,EAAE,aAAa,CAAC;IACtB,8FAA8F;IAC9F,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAAC;IACrF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAsDD;;;;;;GAMG;AACH,qBAAa,6BAA8B,YAAW,SAAS,CAAC,kBAAkB,CAAC;;IACjF,QAAQ,CAAC,EAAE,sBAAY;IACvB,QAAQ,CAAC,OAAO,sBAAY;gBAGhB,IAAI,EAAE,gCAAgC;IAI5C,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAoM1F"}