@mastra/factory 0.12.1-alpha.1 → 0.13.0-alpha.2

package/dist/supervisor/read-tools.js

@@ -0,0 +1,338 @@
+import { FACTORY_RULE_STAGES, factoryRuleStage } from "../rules/types.js";
+import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
+import { runFactoryHealthCheck } from "./health.js";
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+//#region src/supervisor/read-tools.ts
+const MAX_TEXT = 600;
+const MAX_ERROR = 400;
+const MAX_LIST = 50;
+function truncate(text, max) {
+	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+function iso(value) {
+	if (!value) return null;
+	const date = value instanceof Date ? value : new Date(value);
+	return Number.isFinite(date.getTime()) ? date.toISOString() : null;
+}
+function itemNumber(item) {
+	const number = item.metadata?.number ?? item.metadata?.githubIssueNumber ?? item.metadata?.githubPullRequestNumber;
+	return typeof number === "number" ? number : null;
+}
+function itemLabels(item) {
+	const labels = item.metadata?.labels;
+	return Array.isArray(labels) ? labels.filter((label) => typeof label === "string") : [];
+}
+function summarizeItem(item) {
+	return {
+		id: item.id,
+		number: itemNumber(item),
+		title: item.title,
+		stage: factoryRuleStage(item.stages) ?? item.stages.join("+"),
+		source: item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : "manual",
+		url: typeof item.metadata?.url === "string" ? item.metadata.url : null,
+		triageType: item.triageType,
+		acceptedAt: iso(item.acceptedAt),
+		autonomyArmedAt: iso(item.autonomyArmedAt),
+		parentWorkItemId: item.parentWorkItemId,
+		revision: item.revision,
+		updatedAt: iso(item.updatedAt)
+	};
+}
+function summarizeDecision(decision) {
+	const type = typeof decision.decision.type === "string" ? decision.decision.type : "decision";
+	const role = typeof decision.decision.role === "string" ? decision.decision.role : null;
+	const skill = typeof decision.decision.skillName === "string" ? decision.decision.skillName : null;
+	return {
+		id: decision.id,
+		workItemId: decision.workItemId,
+		type,
+		role,
+		skill,
+		status: decision.status,
+		attempts: decision.attempts,
+		availableAt: iso(decision.availableAt),
+		leaseOwner: decision.leaseOwner,
+		leaseExpiresAt: iso(decision.leaseExpiresAt),
+		failureCode: decision.failureCode,
+		failureLabel: decision.failureCode ? factoryDispatchFailureMetadata(decision.failureCode).label : null,
+		canRetry: decision.status === "failed" ? factoryDispatchFailureMetadata(decision.failureCode).canRetry : false,
+		lastError: decision.lastError ? truncate(decision.lastError, MAX_ERROR) : null,
+		approvedBy: decision.approvedBy,
+		createdAt: iso(decision.createdAt),
+		updatedAt: iso(decision.updatedAt),
+		completedAt: iso(decision.completedAt)
+	};
+}
+function messageParts(content) {
+	if (Array.isArray(content)) return content;
+	if (content && typeof content === "object") {
+		const parts = content.parts;
+		if (Array.isArray(parts)) return parts;
+	}
+	return [];
+}
+function messageText(message) {
+	const content = message.content;
+	const parts = messageParts(content);
+	const text = [];
+	for (const part of parts) if (part && typeof part === "object" && part.type === "text") {
+		const value = part.text;
+		if (typeof value === "string") text.push(value);
+	}
+	if (text.length === 0 && typeof content === "string") text.push(content);
+	return text.join("\n");
+}
+function messageToolCalls(message) {
+	const parts = messageParts(message.content);
+	const calls = [];
+	for (const rawPart of parts) {
+		if (!rawPart || typeof rawPart !== "object") continue;
+		const part = rawPart;
+		const invocation = part.type === "tool-invocation" && part.toolInvocation && typeof part.toolInvocation === "object" ? part.toolInvocation : typeof part.type === "string" && part.type.startsWith("tool-") ? part : void 0;
+		if (!invocation) continue;
+		const name = invocation.toolName ?? invocation.name ?? (typeof part.type === "string" ? part.type.slice(5) : null);
+		if (typeof name !== "string") continue;
+		calls.push({
+			tool: name,
+			state: typeof invocation.state === "string" ? invocation.state : null
+		});
+	}
+	return calls;
+}
+async function findItem(deps, ref) {
+	if (ref.id) return deps.workItems.getForProject(deps.scope.orgId, deps.scope.factoryProjectId, ref.id);
+	if (ref.number === void 0) return null;
+	const matches = (await deps.workItems.list(deps.scope)).filter((item) => itemNumber(item) === ref.number);
+	return matches.find((item) => item.externalSource?.type !== "pull-request") ?? matches[0] ?? null;
+}
+const itemRefSchema = z.object({
+	id: z.string().uuid().optional().describe("Work item id."),
+	number: z.number().int().positive().optional().describe("Card number as shown on the board, e.g. 22874.")
+}).refine((ref) => ref.id !== void 0 || ref.number !== void 0, { message: "Provide an id or a number." });
+function createFactorySupervisorReadTools(deps) {
+	const now = deps.now ?? (() => /* @__PURE__ */ new Date());
+	const scope = deps.scope;
+	return {
+		factory_overview: createTool({
+			id: "factory_overview",
+			description: "Counts per pipeline stage, decisions by status, active seats, open proposals and held cards for this Factory. Start here for \"what needs me\" questions.",
+			inputSchema: z.object({}).strict(),
+			execute: async () => {
+				const [items, decisions, bindings, pendingStarts] = await Promise.all([
+					deps.workItems.list(scope),
+					deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId),
+					deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId),
+					deps.workItems.listPendingStarts(scope.orgId, scope.factoryProjectId)
+				]);
+				const stages = Object.fromEntries(FACTORY_RULE_STAGES.map((stage) => [stage, 0]));
+				let held = 0;
+				for (const item of items) {
+					const stage = factoryRuleStage(item.stages);
+					if (stage) stages[stage] += 1;
+					if (stage === "triage" && item.triageType && item.triageType !== "bug" && !item.acceptedAt) held += 1;
+				}
+				const decisionsByStatus = {};
+				for (const decision of decisions) decisionsByStatus[decision.status] = (decisionsByStatus[decision.status] ?? 0) + 1;
+				const activeSeats = bindings.filter((binding) => binding.status === "active");
+				const seatsByRole = {};
+				for (const seat of activeSeats) seatsByRole[seat.role] = (seatsByRole[seat.role] ?? 0) + 1;
+				return {
+					checkedAt: now().toISOString(),
+					workItems: {
+						total: items.length,
+						byStage: stages,
+						heldForDecision: held
+					},
+					decisions: decisionsByStatus,
+					openProposals: decisions.filter((d) => d.status === "proposed").map(summarizeDecision).slice(0, MAX_LIST),
+					failedDecisions: decisions.filter((d) => d.status === "failed").map(summarizeDecision).slice(0, MAX_LIST),
+					activeSeats: {
+						total: activeSeats.length,
+						byRole: seatsByRole
+					},
+					pendingStarts: pendingStarts.filter((start) => start.status !== "sent").length
+				};
+			}
+		}),
+		factory_health_check: createTool({
+			id: "factory_health_check",
+			description: "Deterministic list of things wrong with this Factory right now (failed or stuck decisions, stalled starts, orphaned or missing seats, proposals and held cards waiting on a person, label drift). Each finding carries evidence and the standard repair. Explain these; do not invent findings that are not listed.",
+			inputSchema: z.object({}).strict(),
+			execute: async () => runFactoryHealthCheck(deps.workItems, scope, {
+				now: now(),
+				thresholds: deps.healthThresholds
+			})
+		}),
+		factory_inspect_work_item: createTool({
+			id: "factory_inspect_work_item",
+			description: "Everything the Factory knows about one card: row, stage history, seats (run bindings), decisions with errors, recent audit events, recent feed comments, linked parent/children and last observed labels. Use for \"why is #N in this state\".",
+			inputSchema: itemRefSchema,
+			execute: async (ref) => {
+				const item = await findItem(deps, ref);
+				if (!item) throw new Error(`No work item matches ${ref.id ?? `#${ref.number}`} in this Factory.`);
+				const [decisions, bindings, audit, feed, all] = await Promise.all([
+					deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId),
+					deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id),
+					deps.audit.list({
+						orgId: scope.orgId,
+						factoryProjectId: scope.factoryProjectId,
+						limit: 200
+					}),
+					deps.comments.listRecent({
+						...scope,
+						workItemId: item.id,
+						limit: 10
+					}),
+					deps.workItems.list(scope)
+				]);
+				const parent = item.parentWorkItemId ? all.find((candidate) => candidate.id === item.parentWorkItemId) : void 0;
+				const children = all.filter((candidate) => candidate.parentWorkItemId === item.id);
+				return {
+					item: summarizeItem(item),
+					labels: itemLabels(item),
+					stageHistory: item.stageHistory.map((entry) => ({
+						stage: entry.stage,
+						enteredAt: entry.enteredAt,
+						exitedAt: entry.exitedAt ?? null,
+						by: entry.by
+					})),
+					sessions: Object.entries(item.sessions).map(([role, ref]) => ({
+						role,
+						sessionId: ref.sessionId,
+						threadId: ref.threadId,
+						branch: ref.branch,
+						startedBy: ref.startedBy
+					})),
+					seats: bindings.map((binding) => ({
+						id: binding.id,
+						role: binding.role,
+						status: binding.status,
+						sessionId: binding.sessionId,
+						threadId: binding.threadId,
+						createdAt: iso(binding.createdAt),
+						revokedAt: iso(binding.revokedAt)
+					})),
+					decisions: decisions.filter((decision) => decision.workItemId === item.id).map(summarizeDecision).slice(-50),
+					audit: audit.events.filter((event) => event.targets.some((target) => target.type === "work_item" && target.id === item.id)).slice(0, 25).map((event) => ({
+						id: event.id,
+						action: event.action,
+						actorId: event.actorId,
+						actorType: event.actorType,
+						occurredAt: iso(event.occurredAt),
+						metadata: event.metadata
+					})),
+					feed: feed.map((comment) => ({
+						id: comment.id,
+						kind: comment.kind,
+						author: comment.author,
+						occurredAt: iso(comment.occurredAt),
+						body: truncate(comment.body, MAX_TEXT)
+					})),
+					parent: parent ? summarizeItem(parent) : null,
+					children: children.map(summarizeItem)
+				};
+			}
+		}),
+		factory_list_attention: createTool({
+			id: "factory_list_attention",
+			description: "Failed decisions grouped by failure code and error text, so a batch of cards that broke the same way reads as one incident. Also lists proposals waiting on a person and terminal cards that still hold seats.",
+			inputSchema: z.object({ limit: z.number().int().min(1).max(MAX_LIST).default(25) }).strict(),
+			execute: async ({ limit }) => {
+				const [decisions, items] = await Promise.all([deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId), deps.workItems.list(scope)]);
+				const itemsById = new Map(items.map((item) => [item.id, item]));
+				const groups = /* @__PURE__ */ new Map();
+				for (const decision of decisions) {
+					if (decision.status !== "failed") continue;
+					const error = truncate(decision.lastError ?? "", 160);
+					const key = `${decision.failureCode ?? "unknown"}|${error}`;
+					const group = groups.get(key) ?? {
+						failureCode: decision.failureCode ?? "unknown",
+						error,
+						decisions: []
+					};
+					group.decisions.push(decision);
+					groups.set(key, group);
+				}
+				return {
+					incidents: [...groups.values()].sort((a, b) => b.decisions.length - a.decisions.length).slice(0, limit).map((group) => ({
+						failureCode: group.failureCode,
+						failureLabel: factoryDispatchFailureMetadata(group.decisions[0].failureCode).label,
+						error: group.error,
+						count: group.decisions.length,
+						firstFailedAt: iso(new Date(group.decisions.reduce((earliest, decision) => Math.min(earliest, decision.updatedAt.getTime()), Infinity))),
+						lastFailedAt: iso(new Date(group.decisions.reduce((latest, decision) => Math.max(latest, decision.updatedAt.getTime()), -Infinity))),
+						decisions: group.decisions.slice(0, limit).map((decision) => {
+							const item = decision.workItemId ? itemsById.get(decision.workItemId) : void 0;
+							return {
+								id: decision.id,
+								workItemId: decision.workItemId,
+								number: item ? itemNumber(item) : null,
+								title: item?.title ?? null,
+								attempts: decision.attempts
+							};
+						})
+					})),
+					proposals: decisions.filter((d) => d.status === "proposed").slice(0, limit).map(summarizeDecision)
+				};
+			}
+		}),
+		factory_read_session: createTool({
+			id: "factory_read_session",
+			description: "The most recent turns of a card's shared agent thread: who spoke, when, the text (truncated) and which tools were called. Use to see what a worker actually did. Give a work item (id or number) or a threadId.",
+			inputSchema: z.object({
+				id: z.string().uuid().optional(),
+				number: z.number().int().positive().optional(),
+				threadId: z.string().min(1).optional(),
+				limit: z.number().int().min(1).max(40).default(20)
+			}).strict().refine((ref) => ref.id !== void 0 || ref.number !== void 0 || ref.threadId !== void 0, { message: "Provide a work item id, a number, or a threadId." }),
+			execute: async ({ limit, ...ref }) => {
+				if (!deps.messageReader) throw new Error("Session transcripts are not available on this deployment.");
+				let threadId = ref.threadId;
+				let resourceId;
+				if (!threadId) {
+					const item = await findItem(deps, ref);
+					if (!item) throw new Error(`No work item matches ${ref.id ?? `#${ref.number}`} in this Factory.`);
+					const session = Object.values(item.sessions)[0];
+					if (!session) return {
+						threadId: null,
+						item: summarizeItem(item),
+						turns: []
+					};
+					threadId = session.threadId;
+					resourceId = session.sessionId;
+				} else {
+					const binding = (await deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId)).find((candidate) => candidate.threadId === threadId);
+					if (!binding) throw new Error(`Thread ${threadId} is not bound to a card in this Factory.`);
+					resourceId = binding.resourceId;
+				}
+				const page = await deps.messageReader.listMessages({
+					threadId,
+					...resourceId ? { resourceId } : {},
+					page: 0,
+					perPage: limit,
+					orderBy: {
+						field: "createdAt",
+						direction: "DESC"
+					}
+				});
+				const turns = [...page.messages].reverse().map((message) => ({
+					id: message.id,
+					role: message.role,
+					createdAt: iso(message.createdAt),
+					text: truncate(messageText(message), MAX_TEXT),
+					tools: messageToolCalls(message)
+				}));
+				return {
+					threadId,
+					hasOlder: page.hasMore,
+					turns
+				};
+			}
+		})
+	};
+}
+//#endregion
+export { createFactorySupervisorReadTools };
+
+//# sourceMappingURL=read-tools.js.map

package/dist/supervisor/read-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.js","names":[],"sources":["../../src/supervisor/read-tools.ts"],"sourcesContent":["/**\n * Supervisor read surface. Every tool is bounded (hard row caps, truncated\n * text) and answers with ids a person can click on the board, so the model\n * can explain a card's state without ever touching the database itself.\n */\n\nimport type { MastraDBMessage } from '@mastra/core/agent/message-list';\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport type { IntegrationTools } from '../integrations/base.js';\nimport { factoryDispatchFailureMetadata } from '../rules/dispatch-errors.js';\nimport { FACTORY_RULE_STAGES, factoryRuleStage } from '../rules/types.js';\nimport type { FactoryRuleStage } from '../rules/types.js';\nimport type { AuditStorage } from '../storage/domains/audit/base.js';\nimport type { WorkItemCommentsStorage } from '../storage/domains/comments/base.js';\nimport type {\n  FactoryDeferredDecisionRecord,\n  WorkItemRow,\n  WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\nimport type { FactoryHealthReport, FactoryHealthThresholds } from './health.js';\nimport { runFactoryHealthCheck } from './health.js';\n\nexport interface SupervisorScope {\n  orgId: string;\n  factoryProjectId: string;\n}\n\nexport interface SupervisorMessageReader {\n  listMessages(input: {\n    threadId: string;\n    resourceId?: string;\n    page: number;\n    perPage: number;\n    orderBy: { field: 'createdAt'; direction: 'ASC' | 'DESC' };\n  }): Promise<{ messages: MastraDBMessage[]; hasMore: boolean }>;\n}\n\nexport interface SupervisorReadDependencies {\n  scope: SupervisorScope;\n  workItems: WorkItemsStorage;\n  comments: WorkItemCommentsStorage;\n  audit: AuditStorage;\n  messageReader?: SupervisorMessageReader;\n  healthThresholds?: FactoryHealthThresholds;\n  now?: () => Date;\n}\n\nconst MAX_TEXT = 600;\nconst MAX_ERROR = 400;\nconst MAX_LIST = 50;\n\nfunction truncate(text: string, max: number): string {\n  return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\nfunction iso(value: Date | string | null | undefined): string | null {\n  if (!value) return null;\n  const date = value instanceof Date ? value : new Date(value);\n  return Number.isFinite(date.getTime()) ? date.toISOString() : null;\n}\n\nfunction itemNumber(item: WorkItemRow): number | null {\n  const number = item.metadata?.number ?? item.metadata?.githubIssueNumber ?? item.metadata?.githubPullRequestNumber;\n  return typeof number === 'number' ? number : null;\n}\n\nfunction itemLabels(item: WorkItemRow): string[] {\n  const labels = item.metadata?.labels;\n  return Array.isArray(labels) ? labels.filter((label): label is string => typeof label === 'string') : [];\n}\n\nfunction summarizeItem(item: WorkItemRow) {\n  return {\n    id: item.id,\n    number: itemNumber(item),\n    title: item.title,\n    stage: factoryRuleStage(item.stages) ?? item.stages.join('+'),\n    source: item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : 'manual',\n    url: typeof item.metadata?.url === 'string' ? item.metadata.url : null,\n    triageType: item.triageType,\n    acceptedAt: iso(item.acceptedAt),\n    autonomyArmedAt: iso(item.autonomyArmedAt),\n    parentWorkItemId: item.parentWorkItemId,\n    revision: item.revision,\n    updatedAt: iso(item.updatedAt),\n  };\n}\n\nfunction summarizeDecision(decision: FactoryDeferredDecisionRecord) {\n  const type = typeof decision.decision.type === 'string' ? decision.decision.type : 'decision';\n  const role = typeof decision.decision.role === 'string' ? decision.decision.role : null;\n  const skill = typeof decision.decision.skillName === 'string' ? decision.decision.skillName : null;\n  return {\n    id: decision.id,\n    workItemId: decision.workItemId,\n    type,\n    role,\n    skill,\n    status: decision.status,\n    attempts: decision.attempts,\n    availableAt: iso(decision.availableAt),\n    leaseOwner: decision.leaseOwner,\n    leaseExpiresAt: iso(decision.leaseExpiresAt),\n    failureCode: decision.failureCode,\n    failureLabel: decision.failureCode ? factoryDispatchFailureMetadata(decision.failureCode).label : null,\n    canRetry: decision.status === 'failed' ? factoryDispatchFailureMetadata(decision.failureCode).canRetry : false,\n    lastError: decision.lastError ? truncate(decision.lastError, MAX_ERROR) : null,\n    approvedBy: decision.approvedBy,\n    createdAt: iso(decision.createdAt),\n    updatedAt: iso(decision.updatedAt),\n    completedAt: iso(decision.completedAt),\n  };\n}\n\nfunction messageParts(content: unknown): unknown[] {\n  if (Array.isArray(content)) return content;\n  if (content && typeof content === 'object') {\n    const parts = (content as { parts?: unknown }).parts;\n    if (Array.isArray(parts)) return parts;\n  }\n  return [];\n}\n\nfunction messageText(message: MastraDBMessage): string {\n  const content: unknown = message.content;\n  const parts = messageParts(content);\n  const text: string[] = [];\n  for (const part of parts) {\n    if (part && typeof part === 'object' && (part as { type?: unknown }).type === 'text') {\n      const value = (part as { text?: unknown }).text;\n      if (typeof value === 'string') text.push(value);\n    }\n  }\n  if (text.length === 0 && typeof content === 'string') text.push(content);\n  return text.join('\\n');\n}\n\nfunction messageToolCalls(message: MastraDBMessage): Array<{ tool: string; state: string | null }> {\n  const parts = messageParts(message.content);\n  const calls: Array<{ tool: string; state: string | null }> = [];\n  for (const rawPart of parts) {\n    if (!rawPart || typeof rawPart !== 'object') continue;\n    const part = rawPart as Record<string, unknown>;\n    const invocation =\n      part.type === 'tool-invocation' && part.toolInvocation && typeof part.toolInvocation === 'object'\n        ? (part.toolInvocation as Record<string, unknown>)\n        : typeof part.type === 'string' && part.type.startsWith('tool-')\n          ? part\n          : undefined;\n    if (!invocation) continue;\n    const name = invocation.toolName ?? invocation.name ?? (typeof part.type === 'string' ? part.type.slice(5) : null);\n    if (typeof name !== 'string') continue;\n    calls.push({ tool: name, state: typeof invocation.state === 'string' ? invocation.state : null });\n  }\n  return calls;\n}\n\nasync function findItem(\n  deps: SupervisorReadDependencies,\n  ref: { id?: string; number?: number },\n): Promise<WorkItemRow | null> {\n  if (ref.id) return deps.workItems.getForProject(deps.scope.orgId, deps.scope.factoryProjectId, ref.id);\n  if (ref.number === undefined) return null;\n  const items = await deps.workItems.list(deps.scope);\n  const matches = items.filter(item => itemNumber(item) === ref.number);\n  // Issue and PR numbers share a space on GitHub; prefer the Work-board card.\n  return matches.find(item => item.externalSource?.type !== 'pull-request') ?? matches[0] ?? null;\n}\n\nconst itemRefSchema = z\n  .object({\n    id: z.string().uuid().optional().describe('Work item id.'),\n    number: z.number().int().positive().optional().describe('Card number as shown on the board, e.g. 22874.'),\n  })\n  .refine(ref => ref.id !== undefined || ref.number !== undefined, { message: 'Provide an id or a number.' });\n\nexport function createFactorySupervisorReadTools(deps: SupervisorReadDependencies): IntegrationTools {\n  const now = deps.now ?? (() => new Date());\n  const scope = deps.scope;\n\n  return {\n    factory_overview: createTool({\n      id: 'factory_overview',\n      description:\n        'Counts per pipeline stage, decisions by status, active seats, open proposals and held cards for this Factory. Start here for \"what needs me\" questions.',\n      inputSchema: z.object({}).strict(),\n      execute: async () => {\n        const [items, decisions, bindings, pendingStarts] = await Promise.all([\n          deps.workItems.list(scope),\n          deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId),\n          deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId),\n          deps.workItems.listPendingStarts(scope.orgId, scope.factoryProjectId),\n        ]);\n        const stages = Object.fromEntries(FACTORY_RULE_STAGES.map(stage => [stage, 0])) as Record<\n          FactoryRuleStage,\n          number\n        >;\n        let held = 0;\n        for (const item of items) {\n          const stage = factoryRuleStage(item.stages);\n          if (stage) stages[stage] += 1;\n          if (stage === 'triage' && item.triageType && item.triageType !== 'bug' && !item.acceptedAt) held += 1;\n        }\n        const decisionsByStatus: Record<string, number> = {};\n        for (const decision of decisions) {\n          decisionsByStatus[decision.status] = (decisionsByStatus[decision.status] ?? 0) + 1;\n        }\n        const activeSeats = bindings.filter(binding => binding.status === 'active');\n        const seatsByRole: Record<string, number> = {};\n        for (const seat of activeSeats) seatsByRole[seat.role] = (seatsByRole[seat.role] ?? 0) + 1;\n        return {\n          checkedAt: now().toISOString(),\n          workItems: { total: items.length, byStage: stages, heldForDecision: held },\n          decisions: decisionsByStatus,\n          openProposals: decisions\n            .filter(d => d.status === 'proposed')\n            .map(summarizeDecision)\n            .slice(0, MAX_LIST),\n          failedDecisions: decisions\n            .filter(d => d.status === 'failed')\n            .map(summarizeDecision)\n            .slice(0, MAX_LIST),\n          activeSeats: { total: activeSeats.length, byRole: seatsByRole },\n          pendingStarts: pendingStarts.filter(start => start.status !== 'sent').length,\n        };\n      },\n    }),\n\n    factory_health_check: createTool({\n      id: 'factory_health_check',\n      description:\n        'Deterministic list of things wrong with this Factory right now (failed or stuck decisions, stalled starts, orphaned or missing seats, proposals and held cards waiting on a person, label drift). Each finding carries evidence and the standard repair. Explain these; do not invent findings that are not listed.',\n      inputSchema: z.object({}).strict(),\n      execute: async (): Promise<FactoryHealthReport> =>\n        runFactoryHealthCheck(deps.workItems, scope, { now: now(), thresholds: deps.healthThresholds }),\n    }),\n\n    factory_inspect_work_item: createTool({\n      id: 'factory_inspect_work_item',\n      description:\n        'Everything the Factory knows about one card: row, stage history, seats (run bindings), decisions with errors, recent audit events, recent feed comments, linked parent/children and last observed labels. Use for \"why is #N in this state\".',\n      inputSchema: itemRefSchema,\n      execute: async ref => {\n        const item = await findItem(deps, ref);\n        if (!item) throw new Error(`No work item matches ${ref.id ?? `#${ref.number}`} in this Factory.`);\n        const [decisions, bindings, audit, feed, all] = await Promise.all([\n          deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId),\n          deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id),\n          deps.audit.list({ orgId: scope.orgId, factoryProjectId: scope.factoryProjectId, limit: 200 }),\n          deps.comments.listRecent({ ...scope, workItemId: item.id, limit: 10 }),\n          deps.workItems.list(scope),\n        ]);\n        const parent = item.parentWorkItemId\n          ? all.find(candidate => candidate.id === item.parentWorkItemId)\n          : undefined;\n        const children = all.filter(candidate => candidate.parentWorkItemId === item.id);\n        return {\n          item: summarizeItem(item),\n          labels: itemLabels(item),\n          stageHistory: item.stageHistory.map(entry => ({\n            stage: entry.stage,\n            enteredAt: entry.enteredAt,\n            exitedAt: entry.exitedAt ?? null,\n            by: entry.by,\n          })),\n          sessions: Object.entries(item.sessions).map(([role, ref]) => ({\n            role,\n            sessionId: ref.sessionId,\n            threadId: ref.threadId,\n            branch: ref.branch,\n            startedBy: ref.startedBy,\n          })),\n          seats: bindings.map(binding => ({\n            id: binding.id,\n            role: binding.role,\n            status: binding.status,\n            sessionId: binding.sessionId,\n            threadId: binding.threadId,\n            createdAt: iso(binding.createdAt),\n            revokedAt: iso(binding.revokedAt),\n          })),\n          decisions: decisions\n            .filter(decision => decision.workItemId === item.id)\n            .map(summarizeDecision)\n            .slice(-MAX_LIST),\n          audit: audit.events\n            .filter(event => event.targets.some(target => target.type === 'work_item' && target.id === item.id))\n            .slice(0, 25)\n            .map(event => ({\n              id: event.id,\n              action: event.action,\n              actorId: event.actorId,\n              actorType: event.actorType,\n              occurredAt: iso(event.occurredAt),\n              metadata: event.metadata,\n            })),\n          feed: feed.map(comment => ({\n            id: comment.id,\n            kind: comment.kind,\n            author: comment.author,\n            occurredAt: iso(comment.occurredAt),\n            body: truncate(comment.body, MAX_TEXT),\n          })),\n          parent: parent ? summarizeItem(parent) : null,\n          children: children.map(summarizeItem),\n        };\n      },\n    }),\n\n    factory_list_attention: createTool({\n      id: 'factory_list_attention',\n      description:\n        'Failed decisions grouped by failure code and error text, so a batch of cards that broke the same way reads as one incident. Also lists proposals waiting on a person and terminal cards that still hold seats.',\n      inputSchema: z.object({ limit: z.number().int().min(1).max(MAX_LIST).default(25) }).strict(),\n      execute: async ({ limit }) => {\n        const [decisions, items] = await Promise.all([\n          deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId),\n          deps.workItems.list(scope),\n        ]);\n        const itemsById = new Map(items.map(item => [item.id, item]));\n        const groups = new Map<\n          string,\n          { failureCode: string; error: string; decisions: FactoryDeferredDecisionRecord[] }\n        >();\n        for (const decision of decisions) {\n          if (decision.status !== 'failed') continue;\n          const error = truncate(decision.lastError ?? '', 160);\n          const key = `${decision.failureCode ?? 'unknown'}|${error}`;\n          const group = groups.get(key) ?? { failureCode: decision.failureCode ?? 'unknown', error, decisions: [] };\n          group.decisions.push(decision);\n          groups.set(key, group);\n        }\n        const incidents = [...groups.values()]\n          .sort((a, b) => b.decisions.length - a.decisions.length)\n          .slice(0, limit)\n          .map(group => ({\n            failureCode: group.failureCode,\n            failureLabel: factoryDispatchFailureMetadata(group.decisions[0]!.failureCode).label,\n            error: group.error,\n            count: group.decisions.length,\n            firstFailedAt: iso(\n              new Date(\n                group.decisions.reduce(\n                  (earliest, decision) => Math.min(earliest, decision.updatedAt.getTime()),\n                  Infinity,\n                ),\n              ),\n            ),\n            lastFailedAt: iso(\n              new Date(\n                group.decisions.reduce((latest, decision) => Math.max(latest, decision.updatedAt.getTime()), -Infinity),\n              ),\n            ),\n            decisions: group.decisions.slice(0, limit).map(decision => {\n              const item = decision.workItemId ? itemsById.get(decision.workItemId) : undefined;\n              return {\n                id: decision.id,\n                workItemId: decision.workItemId,\n                number: item ? itemNumber(item) : null,\n                title: item?.title ?? null,\n                attempts: decision.attempts,\n              };\n            }),\n          }));\n        return {\n          incidents,\n          proposals: decisions\n            .filter(d => d.status === 'proposed')\n            .slice(0, limit)\n            .map(summarizeDecision),\n        };\n      },\n    }),\n\n    factory_read_session: createTool({\n      id: 'factory_read_session',\n      description:\n        \"The most recent turns of a card's shared agent thread: who spoke, when, the text (truncated) and which tools were called. Use to see what a worker actually did. Give a work item (id or number) or a threadId.\",\n      inputSchema: z\n        .object({\n          id: z.string().uuid().optional(),\n          number: z.number().int().positive().optional(),\n          threadId: z.string().min(1).optional(),\n          limit: z.number().int().min(1).max(40).default(20),\n        })\n        .strict()\n        .refine(ref => ref.id !== undefined || ref.number !== undefined || ref.threadId !== undefined, {\n          message: 'Provide a work item id, a number, or a threadId.',\n        }),\n      execute: async ({ limit, ...ref }) => {\n        if (!deps.messageReader) throw new Error('Session transcripts are not available on this deployment.');\n        let threadId = ref.threadId;\n        let resourceId: string | undefined;\n        if (!threadId) {\n          const item = await findItem(deps, ref);\n          if (!item) throw new Error(`No work item matches ${ref.id ?? `#${ref.number}`} in this Factory.`);\n          const session = Object.values(item.sessions)[0];\n          if (!session) return { threadId: null, item: summarizeItem(item), turns: [] };\n          threadId = session.threadId;\n          resourceId = session.sessionId;\n        } else {\n          // A thread the caller named must still belong to a card in this Factory.\n          const bindings = await deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId);\n          const binding = bindings.find(candidate => candidate.threadId === threadId);\n          if (!binding) throw new Error(`Thread ${threadId} is not bound to a card in this Factory.`);\n          resourceId = binding.resourceId;\n        }\n        const page = await deps.messageReader.listMessages({\n          threadId,\n          ...(resourceId ? { resourceId } : {}),\n          page: 0,\n          perPage: limit,\n          orderBy: { field: 'createdAt', direction: 'DESC' },\n        });\n        const turns = [...page.messages].reverse().map(message => ({\n          id: message.id,\n          role: message.role,\n          createdAt: iso(message.createdAt),\n          text: truncate(messageText(message), MAX_TEXT),\n          tools: messageToolCalls(message),\n        }));\n        return { threadId, hasOlder: page.hasMore, turns };\n      },\n    }),\n  };\n}\n"],"mappings":"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"}

package/dist/supervisor/session.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The supervisor session: one per factory, addressed by a self-describing
+ * resourceId so a restarted server can recover its scope without a lookup
+ * table. The session has no repository, no sandbox and no work-item seat —
+ * its tools talk to storage directly.
+ */
+import type { MastraCodeState } from '@mastra/code-sdk/schema';
+import type { AgentController } from '@mastra/core/agent-controller';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { MemorySettingsStorage } from '../storage/domains/memory-settings/base.js';
+import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
+import type { SupervisorScope } from './read-tools.js';
+type FactorySession = Awaited<ReturnType<AgentController<MastraCodeState>['createSession']>>;
+export declare function supervisorResourceId(factoryProjectId: string): string;
+/** The supervisor thread shares the session's id: one thread per factory. */
+export declare function supervisorThreadId(factoryProjectId: string): string;
+export declare function parseSupervisorResourceId(resourceId: string | undefined | null): string | null;
+/**
+ * Scope a request to a supervisor session the caller is allowed to drive:
+ * the resourceId must name a project, and the caller's org must own it.
+ * Anything else yields null and the supervisor tools stay unregistered.
+ */
+export declare function resolveSupervisorScope(options: {
+    requestContext: RequestContext | undefined;
+    projects: Pick<FactoryProjectsStorage, 'get'>;
+}): Promise<SupervisorScope | null>;
+/**
+ * Session-start hook: stamp the owning project onto a supervisor session and
+ * apply the factory's default model and memory settings. Runs on every
+ * (re)creation so a restarted server heals the in-memory state. Sessions
+ * that are not supervisors are left untouched.
+ */
+export declare function hydrateSupervisorSession(session: FactorySession, deps: {
+    projects: Pick<FactoryProjectsStorage, 'getById'>;
+    memorySettings?: MemorySettingsStorage;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/supervisor/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/supervisor/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAiC,MAAM,+BAA+B,CAAC;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIvD,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AAE7F,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAI9F;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;CAC/C,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAWlC;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE;IAAE,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;IAAC,cAAc,CAAC,EAAE,qBAAqB,CAAA;CAAE,GAClG,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/supervisor/session.js

@@ -0,0 +1,63 @@
+import { getFactoryAuthOrgId, getFactoryAuthUserFromContext } from "../auth.js";
+import { hydrateFactorySession } from "../session/factory-session.js";
+//#region src/supervisor/session.ts
+const RESOURCE_PREFIX = "factory-supervisor:";
+function supervisorResourceId(factoryProjectId) {
+	return `${RESOURCE_PREFIX}${factoryProjectId}`;
+}
+/** The supervisor thread shares the session's id: one thread per factory. */
+function supervisorThreadId(factoryProjectId) {
+	return supervisorResourceId(factoryProjectId);
+}
+function parseSupervisorResourceId(resourceId) {
+	if (!resourceId?.startsWith(RESOURCE_PREFIX)) return null;
+	const factoryProjectId = resourceId.slice(19);
+	return factoryProjectId.length > 0 ? factoryProjectId : null;
+}
+/**
+* Scope a request to a supervisor session the caller is allowed to drive:
+* the resourceId must name a project, and the caller's org must own it.
+* Anything else yields null and the supervisor tools stay unregistered.
+*/
+async function resolveSupervisorScope(options) {
+	const { requestContext } = options;
+	if (!requestContext || typeof requestContext.get !== "function") return null;
+	const factoryProjectId = parseSupervisorResourceId(requestContext.get("controller")?.resourceId);
+	if (!factoryProjectId) return null;
+	const orgId = getFactoryAuthOrgId(getFactoryAuthUserFromContext(requestContext));
+	if (!orgId) return null;
+	if (!await options.projects.get({
+		orgId,
+		id: factoryProjectId
+	})) return null;
+	return {
+		orgId,
+		factoryProjectId
+	};
+}
+/**
+* Session-start hook: stamp the owning project onto a supervisor session and
+* apply the factory's default model and memory settings. Runs on every
+* (re)creation so a restarted server heals the in-memory state. Sessions
+* that are not supervisors are left untouched.
+*/
+async function hydrateSupervisorSession(session, deps) {
+	const factoryProjectId = parseSupervisorResourceId(session.identity.getResourceId());
+	if (!factoryProjectId) return;
+	const project = await deps.projects.getById({ id: factoryProjectId });
+	if (!project) return;
+	await session.state.set({
+		factoryProjectId,
+		factoryOrgId: project.orgId
+	});
+	await hydrateFactorySession(session, {
+		orgId: project.orgId,
+		factoryProjectId,
+		defaultModelId: project.defaultModelId ?? void 0,
+		memorySettings: deps.memorySettings
+	});
+}
+//#endregion
+export { hydrateSupervisorSession, parseSupervisorResourceId, resolveSupervisorScope, supervisorResourceId, supervisorThreadId };
+
+//# sourceMappingURL=session.js.map

package/dist/supervisor/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","names":[],"sources":["../../src/supervisor/session.ts"],"sourcesContent":["/**\n * The supervisor session: one per factory, addressed by a self-describing\n * resourceId so a restarted server can recover its scope without a lookup\n * table. The session has no repository, no sandbox and no work-item seat —\n * its tools talk to storage directly.\n */\n\nimport type { MastraCodeState } from '@mastra/code-sdk/schema';\nimport type { AgentController, AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { RequestContext } from '@mastra/core/request-context';\n\nimport { getFactoryAuthOrgId, getFactoryAuthUserFromContext } from '../auth.js';\nimport { hydrateFactorySession } from '../session/factory-session.js';\nimport type { MemorySettingsStorage } from '../storage/domains/memory-settings/base.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { SupervisorScope } from './read-tools.js';\n\nconst RESOURCE_PREFIX = 'factory-supervisor:';\n\ntype FactorySession = Awaited<ReturnType<AgentController<MastraCodeState>['createSession']>>;\n\nexport function supervisorResourceId(factoryProjectId: string): string {\n  return `${RESOURCE_PREFIX}${factoryProjectId}`;\n}\n\n/** The supervisor thread shares the session's id: one thread per factory. */\nexport function supervisorThreadId(factoryProjectId: string): string {\n  return supervisorResourceId(factoryProjectId);\n}\n\nexport function parseSupervisorResourceId(resourceId: string | undefined | null): string | null {\n  if (!resourceId?.startsWith(RESOURCE_PREFIX)) return null;\n  const factoryProjectId = resourceId.slice(RESOURCE_PREFIX.length);\n  return factoryProjectId.length > 0 ? factoryProjectId : null;\n}\n\n/**\n * Scope a request to a supervisor session the caller is allowed to drive:\n * the resourceId must name a project, and the caller's org must own it.\n * Anything else yields null and the supervisor tools stay unregistered.\n */\nexport async function resolveSupervisorScope(options: {\n  requestContext: RequestContext | undefined;\n  projects: Pick<FactoryProjectsStorage, 'get'>;\n}): Promise<SupervisorScope | null> {\n  const { requestContext } = options;\n  if (!requestContext || typeof requestContext.get !== 'function') return null;\n  const context = requestContext.get('controller') as AgentControllerRequestContext<MastraCodeState> | undefined;\n  const factoryProjectId = parseSupervisorResourceId(context?.resourceId);\n  if (!factoryProjectId) return null;\n  const orgId = getFactoryAuthOrgId(getFactoryAuthUserFromContext(requestContext));\n  if (!orgId) return null;\n  const project = await options.projects.get({ orgId, id: factoryProjectId });\n  if (!project) return null;\n  return { orgId, factoryProjectId };\n}\n\n/**\n * Session-start hook: stamp the owning project onto a supervisor session and\n * apply the factory's default model and memory settings. Runs on every\n * (re)creation so a restarted server heals the in-memory state. Sessions\n * that are not supervisors are left untouched.\n */\nexport async function hydrateSupervisorSession(\n  session: FactorySession,\n  deps: { projects: Pick<FactoryProjectsStorage, 'getById'>; memorySettings?: MemorySettingsStorage },\n): Promise<void> {\n  const factoryProjectId = parseSupervisorResourceId(session.identity.getResourceId());\n  if (!factoryProjectId) return;\n  const project = await deps.projects.getById({ id: factoryProjectId });\n  if (!project) return;\n  await session.state.set({\n    factoryProjectId,\n    factoryOrgId: project.orgId,\n  });\n  await hydrateFactorySession(session, {\n    orgId: project.orgId,\n    factoryProjectId,\n    defaultModelId: project.defaultModelId ?? undefined,\n    memorySettings: deps.memorySettings,\n  });\n}\n"],"mappings":";;;AAiBA,MAAM,kBAAkB;AAIxB,SAAgB,qBAAqB,kBAAkC;CACrE,OAAO,GAAG,kBAAkB;AAC9B;;AAGA,SAAgB,mBAAmB,kBAAkC;CACnE,OAAO,qBAAqB,gBAAgB;AAC9C;AAEA,SAAgB,0BAA0B,YAAsD;CAC9F,IAAI,CAAC,YAAY,WAAW,eAAe,GAAG,OAAO;CACrD,MAAM,mBAAmB,WAAW,MAAM,EAAsB;CAChE,OAAO,iBAAiB,SAAS,IAAI,mBAAmB;AAC1D;;;;;;AAOA,eAAsB,uBAAuB,SAGT;CAClC,MAAM,EAAE,mBAAmB;CAC3B,IAAI,CAAC,kBAAkB,OAAO,eAAe,QAAQ,YAAY,OAAO;CAExE,MAAM,mBAAmB,0BADT,eAAe,IAAI,YACsB,CAAC,EAAE,UAAU;CACtE,IAAI,CAAC,kBAAkB,OAAO;CAC9B,MAAM,QAAQ,oBAAoB,8BAA8B,cAAc,CAAC;CAC/E,IAAI,CAAC,OAAO,OAAO;CAEnB,IAAI,CAAC,MADiB,QAAQ,SAAS,IAAI;EAAE;EAAO,IAAI;CAAiB,CAAC,GAC5D,OAAO;CACrB,OAAO;EAAE;EAAO;CAAiB;AACnC;;;;;;;AAQA,eAAsB,yBACpB,SACA,MACe;CACf,MAAM,mBAAmB,0BAA0B,QAAQ,SAAS,cAAc,CAAC;CACnF,IAAI,CAAC,kBAAkB;CACvB,MAAM,UAAU,MAAM,KAAK,SAAS,QAAQ,EAAE,IAAI,iBAAiB,CAAC;CACpE,IAAI,CAAC,SAAS;CACd,MAAM,QAAQ,MAAM,IAAI;EACtB;EACA,cAAc,QAAQ;CACxB,CAAC;CACD,MAAM,sBAAsB,SAAS;EACnC,OAAO,QAAQ;EACf;EACA,gBAAgB,QAAQ,kBAAkB,KAAA;EAC1C,gBAAgB,KAAK;CACvB,CAAC;AACH"}

package/dist/supervisor/write-tools.d.ts

@@ -0,0 +1,26 @@
+import type { IntegrationTools } from '../integrations/base.js';
+import type { FactoryTransitionService } from '../rules/transition-service.js';
+import type { AuditStorage } from '../storage/domains/audit/base.js';
+import type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';
+import type { SupervisorScope } from './read-tools.js';
+interface SupervisorWriteDependencies {
+    scope: SupervisorScope;
+    userId: string;
+    workItems: WorkItemsStorage;
+    audit: AuditStorage;
+    transitionService: FactoryTransitionService;
+    reconcileAcceptanceLabels?: (input: {
+        orgId: string;
+        factoryProjectId: string;
+        item: WorkItemRow;
+    }) => Promise<void>;
+    signalSession?: (input: {
+        sessionId: string;
+        message: string;
+        userId: string;
+    }) => Promise<unknown>;
+    now?: () => Date;
+}
+export declare function createFactorySupervisorWriteTools(deps: SupervisorWriteDependencies): IntegrationTools;
+export {};
+//# sourceMappingURL=write-tools.d.ts.map

package/dist/supervisor/write-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-tools.d.ts","sourceRoot":"","sources":["../../src/supervisor/write-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,UAAU,2BAA2B;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,yBAAyB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpG,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,2BAA2B,GAAG,gBAAgB,CA4LrG"}