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

package/dist/tools/read-tools.js

@@ -0,0 +1,285 @@
+import { boardForWorkItem } from "../boards/semantics.js";
+import "../boards/index.js";
+import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
+import { decisionRetryable, overtakenDecisionIds } from "../rules/decision-applicability.js";
+import { z } from "zod";
+import { createTool } from "@mastra/core/tools";
+//#region src/tools/read-tools.ts
+const MAX_TEXT = 600;
+const MAX_ERROR = 400;
+const MAX_LIST = 50;
+const DEFAULT_LIST = 25;
+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;
+}
+/** The number a person sees on the card: the issue or PR number the item was filed from. */
+function workItemNumber(item) {
+	const number = item.metadata?.number ?? item.metadata?.githubIssueNumber ?? item.metadata?.githubPullRequestNumber;
+	return typeof number === "number" ? number : null;
+}
+function workItemStage(item) {
+	return item.stages.join("+");
+}
+/** A work item id or its card number; anything else can't name an item. */
+const workItemRefSchema = z.string().trim().max(64).refine((ref) => z.string().uuid().safeParse(ref).success || /^#?\d+$/.test(ref), { message: "Use a work item id (UUID) or its number like \"#123\"." }).describe("Work item id, or its number like \"#123\".");
+/** Resolve `<uuid>` or `#123` to an item in this Factory only. Pass a ref validated by `workItemRefSchema`. */
+async function findWorkItem(workItems, scope, ref) {
+	const trimmed = ref.trim();
+	const number = /^#?(\d+)$/.exec(trimmed)?.[1];
+	if (number === void 0) return workItems.getForProject(scope.orgId, scope.factoryProjectId, trimmed);
+	const matches = (await workItems.list(scope)).filter((item) => workItemNumber(item) === Number(number));
+	return matches.find((item) => item.externalSource?.type !== "pull-request") ?? matches[0] ?? null;
+}
+function workItemNotFound(ref) {
+	return /* @__PURE__ */ new Error(`No work item ${ref} was found in this Factory.`);
+}
+function activeWorker(bindings, itemId) {
+	const binding = bindings.find((candidate) => candidate.workItemId === itemId && candidate.status === "active");
+	return binding ? {
+		role: binding.role,
+		sessionId: binding.sessionId
+	} : null;
+}
+function summarizeItem(item, bindings) {
+	return {
+		id: item.id,
+		number: workItemNumber(item),
+		title: truncate(item.title, 600),
+		board: boardForWorkItem(item),
+		stage: workItemStage(item),
+		activeWorker: activeWorker(bindings, item.id),
+		requestedBy: item.createdBy,
+		updatedAt: iso(item.updatedAt)
+	};
+}
+function summarizeDecision(decision, overtaken = false) {
+	const type = typeof decision.decision.type === "string" ? decision.decision.type : "decision";
+	const role = typeof decision.decision.role === "string" ? decision.decision.role : null;
+	return {
+		id: decision.id,
+		workItemId: decision.workItemId,
+		type,
+		role,
+		status: decision.status,
+		attempts: decision.attempts,
+		failureCode: decision.failureCode,
+		failureLabel: decision.failureCode ? factoryDispatchFailureMetadata(decision.failureCode).label : null,
+		canRetry: decisionRetryable(decision, overtaken),
+		error: decision.lastError ? truncate(decision.lastError, 400) : null,
+		approvedBy: decision.approvedBy,
+		updatedAt: iso(decision.updatedAt)
+	};
+}
+/** Held: a non-bug item triage parked until a person accepts it. */
+function isHeld(item) {
+	return item.stages.includes("triage") && !!item.triageType && item.triageType !== "bug" && !item.acceptedAt;
+}
+const listInputSchema = z.object({
+	query: z.string().trim().min(1).max(200).optional().describe("Case-insensitive text in the title, or an exact card number like \"#123\"."),
+	stage: z.string().min(1).max(64).optional().describe("Only items in this stage, e.g. \"triage\" or \"review\"."),
+	board: z.string().min(1).max(64).optional().describe("Only items on this board, e.g. \"work\" or \"review\"."),
+	role: z.string().min(1).max(64).optional().describe("Only items that have a session for this role."),
+	active: z.boolean().optional().describe("true: only items with an agent working now; false: only idle items."),
+	requestedBy: z.literal("me").optional().describe("\"me\": only items you filed."),
+	subscribed: z.boolean().optional().describe("true: only items this session follows; false: only items it does not."),
+	limit: z.number().int().min(1).max(50).optional().describe(`Default ${DEFAULT_LIST}, max 50.`)
+}).strict();
+function createFactoryReadTools(scope, deps) {
+	const project = {
+		orgId: scope.orgId,
+		factoryProjectId: scope.factoryProjectId
+	};
+	return {
+		factory_list_work_items: createTool({
+			id: "factory_list_work_items",
+			description: "List this Factory's work items, newest activity first, with counts per stage for the whole Factory. Filter by text or #number, stage, board, role, whether an agent is working on it, items you filed, or items this session follows. Check here for an existing item before filing a new one.",
+			inputSchema: listInputSchema,
+			execute: async (input) => {
+				const [items, bindings, followed] = await Promise.all([
+					deps.workItems.list(project),
+					deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId),
+					input.subscribed === void 0 ? void 0 : deps.workItems.listSessionSubscriptions({
+						...project,
+						sessionId: scope.sessionId
+					})
+				]);
+				const followedIds = new Set(followed?.map((subscription) => subscription.workItemId));
+				const byStage = {};
+				for (const item of items) {
+					const stage = workItemStage(item);
+					byStage[stage] = (byStage[stage] ?? 0) + 1;
+				}
+				const numberQuery = input.query ? /^#(\d+)$/.exec(input.query)?.[1] : void 0;
+				const text = input.query?.toLowerCase();
+				const matches = items.filter((item) => {
+					if (numberQuery !== void 0) {
+						if (workItemNumber(item) !== Number(numberQuery)) return false;
+					} else if (text && !item.title.toLowerCase().includes(text)) return false;
+					if (input.stage && !item.stages.includes(input.stage)) return false;
+					if (input.board && boardForWorkItem(item) !== input.board) return false;
+					if (input.role && !item.sessions[input.role]) return false;
+					if (input.active !== void 0 && activeWorker(bindings, item.id) !== null !== input.active) return false;
+					if (input.requestedBy === "me" && item.createdBy !== scope.userId) return false;
+					if (input.subscribed !== void 0 && followedIds.has(item.id) !== input.subscribed) return false;
+					return true;
+				}).sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime());
+				const limit = input.limit ?? DEFAULT_LIST;
+				return {
+					counts: {
+						total: items.length,
+						byStage
+					},
+					items: matches.slice(0, limit).map((item) => summarizeItem(item, bindings)),
+					truncated: matches.length > limit
+				};
+			}
+		}),
+		factory_inspect_work_item: createTool({
+			id: "factory_inspect_work_item",
+			description: "Everything the Factory knows about one work item: stage history, sessions by role, decisions with errors, recent audit events, recent feed comments, labels, linked items and the sessions following it. Use it to explain why an item is where it is.",
+			inputSchema: z.object({ workItem: workItemRefSchema }).strict(),
+			execute: async ({ workItem }) => {
+				const item = await findWorkItem(deps.workItems, scope, workItem);
+				if (!item) throw workItemNotFound(workItem);
+				const [bindings, decisions, audit, feed, all, subscribers] = await Promise.all([
+					deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id),
+					deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, { workItemId: item.id }),
+					deps.audit.list({
+						...project,
+						limit: 200
+					}),
+					deps.comments.listRecent({
+						...project,
+						workItemId: item.id,
+						limit: 10
+					}),
+					deps.workItems.list(project),
+					deps.workItems.listWorkItemSubscribers({
+						orgId: scope.orgId,
+						workItemId: item.id
+					})
+				]);
+				const itemDecisions = decisions.slice(-50);
+				const overtaken = await overtakenDecisionIds(deps.workItems, deps.boards, project, itemDecisions.filter((decision) => decision.status === "failed"));
+				const labels = Array.isArray(item.metadata?.labels) ? item.metadata.labels.filter((label) => typeof label === "string").slice(0, 50) : [];
+				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, bindings),
+						source: item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : "manual",
+						url: typeof item.metadata?.url === "string" ? item.metadata.url : null,
+						triageType: item.triageType,
+						revision: item.revision
+					},
+					labels,
+					stageHistory: item.stageHistory.slice(-50).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,
+						startedBy: ref.startedBy,
+						active: bindings.some((binding) => binding.role === role && binding.sessionId === ref.sessionId && binding.status === "active")
+					})),
+					decisions: itemDecisions.map((decision) => summarizeDecision(decision, overtaken.has(decision.id))),
+					audit: audit.events.filter((event) => event.targets.some((target) => target.type === "work_item" && target.id === item.id)).slice(0, 25).map((event) => ({
+						action: event.action,
+						actorId: event.actorId,
+						actorType: event.actorType,
+						occurredAt: iso(event.occurredAt)
+					})),
+					feed: feed.map((comment) => ({
+						id: comment.id,
+						kind: comment.kind,
+						author: comment.author,
+						occurredAt: iso(comment.occurredAt),
+						body: truncate(comment.body, 600)
+					})),
+					parent: parent ? summarizeItem(parent, bindings) : null,
+					children: children.slice(0, 50).map((child) => summarizeItem(child, bindings)),
+					subscribers: subscribers.slice(0, 50).map((subscription) => ({
+						sessionId: subscription.sessionId,
+						reason: subscription.reason,
+						isCaller: subscription.sessionId === scope.sessionId
+					}))
+				};
+			}
+		}),
+		factory_list_attention: createTool({
+			id: "factory_list_attention",
+			description: "What in this Factory needs a person: failed decisions grouped by failure code and error (one incident per group), proposals waiting for approval, and items triage is holding until someone accepts them.",
+			inputSchema: z.object({ limit: z.number().int().min(1).max(50).optional() }).strict(),
+			execute: async ({ limit = DEFAULT_LIST }) => {
+				const [decisions, items] = await Promise.all([deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, { statuses: ["failed", "proposed"] }), deps.workItems.list(project)]);
+				const itemsById = new Map(items.map((item) => [item.id, item]));
+				const failed = decisions.filter((decision) => decision.status === "failed");
+				const groups = /* @__PURE__ */ new Map();
+				for (const decision of failed) {
+					const error = truncate(decision.lastError ?? "", 400);
+					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);
+				}
+				const ref = (workItemId) => {
+					const item = workItemId ? itemsById.get(workItemId) : void 0;
+					return {
+						workItemId,
+						number: item ? workItemNumber(item) : null,
+						title: item ? truncate(item.title, 600) : null
+					};
+				};
+				const allIncidents = [...groups.values()].sort((a, b) => b.decisions.length - a.decisions.length);
+				const incidents = allIncidents.slice(0, limit).map((group) => ({
+					...group,
+					shown: group.decisions.slice(0, limit)
+				}));
+				const overtaken = await overtakenDecisionIds(deps.workItems, deps.boards, project, incidents.flatMap((group) => group.shown));
+				const proposals = decisions.filter((decision) => decision.status === "proposed");
+				const held = items.filter(isHeld);
+				return {
+					incidents: incidents.map((group) => ({
+						failureCode: group.failureCode,
+						failureLabel: factoryDispatchFailureMetadata(group.decisions[0].failureCode).label,
+						error: group.error,
+						count: group.decisions.length,
+						decisions: group.shown.map((decision) => ({
+							id: decision.id,
+							...ref(decision.workItemId),
+							attempts: decision.attempts,
+							canRetry: decisionRetryable(decision, overtaken.has(decision.id))
+						}))
+					})),
+					proposals: proposals.slice(0, limit).map((decision) => ({
+						...summarizeDecision(decision),
+						...ref(decision.workItemId)
+					})),
+					held: held.slice(0, limit).map((item) => ({
+						...ref(item.id),
+						triageType: item.triageType,
+						stage: workItemStage(item)
+					})),
+					truncated: allIncidents.length > limit || incidents.some((group) => group.shown.length < group.decisions.length) || proposals.length > limit || held.length > limit
+				};
+			}
+		})
+	};
+}
+//#endregion
+export { MAX_ERROR, MAX_LIST, MAX_TEXT, createFactoryReadTools, findWorkItem, truncate, workItemNotFound, workItemNumber, workItemRefSchema, workItemStage };
+
+//# sourceMappingURL=read-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.js","names":[],"sources":["../../src/tools/read-tools.ts"],"sourcesContent":["import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { boardForWorkItem } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport type { IntegrationTools } from '../integrations/base.js';\nimport { decisionRetryable, overtakenDecisionIds } from '../rules/decision-applicability.js';\nimport { factoryDispatchFailureMetadata } from '../rules/dispatch-errors.js';\nimport type { AuditStorage } from '../storage/domains/audit/base.js';\nimport type { WorkItemCommentsStorage } from '../storage/domains/comments/base.js';\nimport type {\n  FactoryDeferredDecisionRecord,\n  FactoryRunBindingRecord,\n  WorkItemRow,\n  WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\nimport type { FactoryToolScope } from './scope.js';\n\nexport const MAX_TEXT = 600;\nexport const MAX_ERROR = 400;\nexport const MAX_LIST = 50;\nconst DEFAULT_LIST = 25;\n\nexport interface FactoryReadToolDependencies {\n  workItems: Pick<\n    WorkItemsStorage,\n    | 'list'\n    | 'getForProject'\n    | 'listRunBindings'\n    | 'listDeferredDecisions'\n    | 'listByIds'\n    | 'listDecisionsForEvaluations'\n    | 'listWorkItemSubscribers'\n    | 'listSessionSubscriptions'\n  >;\n  comments: Pick<WorkItemCommentsStorage, 'listRecent'>;\n  audit: Pick<AuditStorage, 'list'>;\n  boards: BoardRegistry;\n}\n\nexport function 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\n/** The number a person sees on the card: the issue or PR number the item was filed from. */\nexport function workItemNumber(item: Pick<WorkItemRow, 'metadata'>): number | null {\n  const number = item.metadata?.number ?? item.metadata?.githubIssueNumber ?? item.metadata?.githubPullRequestNumber;\n  return typeof number === 'number' ? number : null;\n}\n\nexport function workItemStage(item: Pick<WorkItemRow, 'stages'>): string {\n  return item.stages.join('+');\n}\n\n/** A work item id or its card number; anything else can't name an item. */\nexport const workItemRefSchema = z\n  .string()\n  .trim()\n  .max(64)\n  .refine(ref => z.string().uuid().safeParse(ref).success || /^#?\\d+$/.test(ref), {\n    message: 'Use a work item id (UUID) or its number like \"#123\".',\n  })\n  .describe('Work item id, or its number like \"#123\".');\n\n/** Resolve `<uuid>` or `#123` to an item in this Factory only. Pass a ref validated by `workItemRefSchema`. */\nexport async function findWorkItem(\n  workItems: Pick<WorkItemsStorage, 'list' | 'getForProject'>,\n  scope: Pick<FactoryToolScope, 'orgId' | 'factoryProjectId'>,\n  ref: string,\n): Promise<WorkItemRow | null> {\n  const trimmed = ref.trim();\n  const number = /^#?(\\d+)$/.exec(trimmed)?.[1];\n  if (number === undefined) return workItems.getForProject(scope.orgId, scope.factoryProjectId, trimmed);\n  const items = await workItems.list(scope);\n  const matches = items.filter(item => workItemNumber(item) === Number(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\nexport function workItemNotFound(ref: string): Error {\n  return new Error(`No work item ${ref} was found in this Factory.`);\n}\n\nfunction activeWorker(bindings: FactoryRunBindingRecord[], itemId: string) {\n  const binding = bindings.find(candidate => candidate.workItemId === itemId && candidate.status === 'active');\n  return binding ? { role: binding.role, sessionId: binding.sessionId } : null;\n}\n\nfunction summarizeItem(item: WorkItemRow, bindings: FactoryRunBindingRecord[]) {\n  return {\n    id: item.id,\n    number: workItemNumber(item),\n    title: truncate(item.title, MAX_TEXT),\n    board: boardForWorkItem(item),\n    stage: workItemStage(item),\n    activeWorker: activeWorker(bindings, item.id),\n    requestedBy: item.createdBy,\n    updatedAt: iso(item.updatedAt),\n  };\n}\n\nfunction summarizeDecision(decision: FactoryDeferredDecisionRecord, overtaken = false) {\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  return {\n    id: decision.id,\n    workItemId: decision.workItemId,\n    type,\n    role,\n    status: decision.status,\n    attempts: decision.attempts,\n    failureCode: decision.failureCode,\n    failureLabel: decision.failureCode ? factoryDispatchFailureMetadata(decision.failureCode).label : null,\n    canRetry: decisionRetryable(decision, overtaken),\n    error: decision.lastError ? truncate(decision.lastError, MAX_ERROR) : null,\n    approvedBy: decision.approvedBy,\n    updatedAt: iso(decision.updatedAt),\n  };\n}\n\n/** Held: a non-bug item triage parked until a person accepts it. */\nfunction isHeld(item: WorkItemRow): boolean {\n  return item.stages.includes('triage') && !!item.triageType && item.triageType !== 'bug' && !item.acceptedAt;\n}\n\nconst listInputSchema = z\n  .object({\n    query: z\n      .string()\n      .trim()\n      .min(1)\n      .max(200)\n      .optional()\n      .describe('Case-insensitive text in the title, or an exact card number like \"#123\".'),\n    stage: z.string().min(1).max(64).optional().describe('Only items in this stage, e.g. \"triage\" or \"review\".'),\n    board: z.string().min(1).max(64).optional().describe('Only items on this board, e.g. \"work\" or \"review\".'),\n    role: z.string().min(1).max(64).optional().describe('Only items that have a session for this role.'),\n    active: z.boolean().optional().describe('true: only items with an agent working now; false: only idle items.'),\n    requestedBy: z.literal('me').optional().describe('\"me\": only items you filed.'),\n    subscribed: z\n      .boolean()\n      .optional()\n      .describe('true: only items this session follows; false: only items it does not.'),\n    limit: z.number().int().min(1).max(MAX_LIST).optional().describe(`Default ${DEFAULT_LIST}, max ${MAX_LIST}.`),\n  })\n  .strict();\n\nexport function createFactoryReadTools(scope: FactoryToolScope, deps: FactoryReadToolDependencies): IntegrationTools {\n  const project = { orgId: scope.orgId, factoryProjectId: scope.factoryProjectId };\n\n  return {\n    factory_list_work_items: createTool({\n      id: 'factory_list_work_items',\n      description:\n        \"List this Factory's work items, newest activity first, with counts per stage for the whole Factory. Filter by text or #number, stage, board, role, whether an agent is working on it, items you filed, or items this session follows. Check here for an existing item before filing a new one.\",\n      inputSchema: listInputSchema,\n      execute: async input => {\n        const [items, bindings, followed] = await Promise.all([\n          deps.workItems.list(project),\n          deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId),\n          input.subscribed === undefined\n            ? undefined\n            : deps.workItems.listSessionSubscriptions({ ...project, sessionId: scope.sessionId }),\n        ]);\n        const followedIds = new Set(followed?.map(subscription => subscription.workItemId));\n        const byStage: Record<string, number> = {};\n        for (const item of items) {\n          const stage = workItemStage(item);\n          byStage[stage] = (byStage[stage] ?? 0) + 1;\n        }\n        const numberQuery = input.query ? /^#(\\d+)$/.exec(input.query)?.[1] : undefined;\n        const text = input.query?.toLowerCase();\n        const matches = items\n          .filter(item => {\n            if (numberQuery !== undefined) {\n              if (workItemNumber(item) !== Number(numberQuery)) return false;\n            } else if (text && !item.title.toLowerCase().includes(text)) return false;\n            if (input.stage && !item.stages.includes(input.stage)) return false;\n            if (input.board && boardForWorkItem(item) !== input.board) return false;\n            if (input.role && !item.sessions[input.role]) return false;\n            if (input.active !== undefined && (activeWorker(bindings, item.id) !== null) !== input.active) return false;\n            if (input.requestedBy === 'me' && item.createdBy !== scope.userId) return false;\n            if (input.subscribed !== undefined && followedIds.has(item.id) !== input.subscribed) return false;\n            return true;\n          })\n          .sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime());\n        const limit = input.limit ?? DEFAULT_LIST;\n        return {\n          counts: { total: items.length, byStage },\n          items: matches.slice(0, limit).map(item => summarizeItem(item, bindings)),\n          truncated: matches.length > limit,\n        };\n      },\n    }),\n\n    factory_inspect_work_item: createTool({\n      id: 'factory_inspect_work_item',\n      description:\n        'Everything the Factory knows about one work item: stage history, sessions by role, decisions with errors, recent audit events, recent feed comments, labels, linked items and the sessions following it. Use it to explain why an item is where it is.',\n      inputSchema: z.object({ workItem: workItemRefSchema }).strict(),\n      execute: async ({ workItem }) => {\n        const item = await findWorkItem(deps.workItems, scope, workItem);\n        if (!item) throw workItemNotFound(workItem);\n        const [bindings, decisions, audit, feed, all, subscribers] = await Promise.all([\n          deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id),\n          deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, { workItemId: item.id }),\n          deps.audit.list({ ...project, limit: 200 }),\n          deps.comments.listRecent({ ...project, workItemId: item.id, limit: 10 }),\n          deps.workItems.list(project),\n          deps.workItems.listWorkItemSubscribers({ orgId: scope.orgId, workItemId: item.id }),\n        ]);\n        const itemDecisions = decisions.slice(-MAX_LIST);\n        const overtaken = await overtakenDecisionIds(\n          deps.workItems,\n          deps.boards,\n          project,\n          itemDecisions.filter(decision => decision.status === 'failed'),\n        );\n        const labels = Array.isArray(item.metadata?.labels)\n          ? item.metadata.labels.filter((label): label is string => typeof label === 'string').slice(0, MAX_LIST)\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: {\n            ...summarizeItem(item, bindings),\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            revision: item.revision,\n          },\n          labels,\n          stageHistory: item.stageHistory.slice(-MAX_LIST).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            startedBy: ref.startedBy,\n            active: bindings.some(\n              binding => binding.role === role && binding.sessionId === ref.sessionId && binding.status === 'active',\n            ),\n          })),\n          decisions: itemDecisions.map(decision => summarizeDecision(decision, overtaken.has(decision.id))),\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              action: event.action,\n              actorId: event.actorId,\n              actorType: event.actorType,\n              occurredAt: iso(event.occurredAt),\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, bindings) : null,\n          children: children.slice(0, MAX_LIST).map(child => summarizeItem(child, bindings)),\n          subscribers: subscribers.slice(0, MAX_LIST).map(subscription => ({\n            sessionId: subscription.sessionId,\n            reason: subscription.reason,\n            isCaller: subscription.sessionId === scope.sessionId,\n          })),\n        };\n      },\n    }),\n\n    factory_list_attention: createTool({\n      id: 'factory_list_attention',\n      description:\n        'What in this Factory needs a person: failed decisions grouped by failure code and error (one incident per group), proposals waiting for approval, and items triage is holding until someone accepts them.',\n      inputSchema: z.object({ limit: z.number().int().min(1).max(MAX_LIST).optional() }).strict(),\n      execute: async ({ limit = DEFAULT_LIST }) => {\n        const [decisions, items] = await Promise.all([\n          deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, {\n            statuses: ['failed', 'proposed'],\n          }),\n          deps.workItems.list(project),\n        ]);\n        const itemsById = new Map(items.map(item => [item.id, item]));\n        const failed = decisions.filter(decision => decision.status === 'failed');\n        const groups = new Map<\n          string,\n          { failureCode: string; error: string; decisions: FactoryDeferredDecisionRecord[] }\n        >();\n        for (const decision of failed) {\n          const error = truncate(decision.lastError ?? '', MAX_ERROR);\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 ref = (workItemId: string | null) => {\n          const item = workItemId ? itemsById.get(workItemId) : undefined;\n          return {\n            workItemId,\n            number: item ? workItemNumber(item) : null,\n            title: item ? truncate(item.title, MAX_TEXT) : null,\n          };\n        };\n        const allIncidents = [...groups.values()].sort((a, b) => b.decisions.length - a.decisions.length);\n        const incidents = allIncidents\n          .slice(0, limit)\n          .map(group => ({ ...group, shown: group.decisions.slice(0, limit) }));\n        // Check exactly the decisions this call returns, so every canRetry is real.\n        const overtaken = await overtakenDecisionIds(\n          deps.workItems,\n          deps.boards,\n          project,\n          incidents.flatMap(group => group.shown),\n        );\n        const proposals = decisions.filter(decision => decision.status === 'proposed');\n        const held = items.filter(isHeld);\n        return {\n          incidents: incidents.map(group => ({\n            failureCode: group.failureCode,\n            failureLabel: factoryDispatchFailureMetadata(group.decisions[0]!.failureCode).label,\n            error: group.error,\n            count: group.decisions.length,\n            decisions: group.shown.map(decision => ({\n              id: decision.id,\n              ...ref(decision.workItemId),\n              attempts: decision.attempts,\n              canRetry: decisionRetryable(decision, overtaken.has(decision.id)),\n            })),\n          })),\n          proposals: proposals\n            .slice(0, limit)\n            .map(decision => ({ ...summarizeDecision(decision), ...ref(decision.workItemId) })),\n          held: held.slice(0, limit).map(item => ({\n            ...ref(item.id),\n            triageType: item.triageType,\n            stage: workItemStage(item),\n          })),\n          truncated:\n            allIncidents.length > limit ||\n            incidents.some(group => group.shown.length < group.decisions.length) ||\n            proposals.length > limit ||\n            held.length > limit,\n        };\n      },\n    }),\n  };\n}\n"],"mappings":"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"}

package/dist/tools/reports.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Reports from sessions doing the work back to whoever follows it: a side
+ * session's origin, or every subscriber of a work item. The agent reports with
+ * `factory_message_origin`; when a run ends without one, the run-end backstop
+ * sends it, so each run produces exactly one final report per recipient.
+ */
+import type { NotificationPriority, NotificationsStorage, SendNotificationSignalInput } from '@mastra/core/notifications';
+import type { SourceControlSessionLookup } from '../session/factory-session.js';
+import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
+import type { FactoryDeliveryResult, FactoryDeliveryTarget } from './deliver.js';
+export type FactoryReportStatus = 'progress' | 'blocked' | 'done' | 'failed';
+/** How each report status travels. Final reports never coalesce, so a later report can't overwrite them. */
+export declare const FACTORY_REPORT_FORMS: Record<FactoryReportStatus | 'report', {
+    kind: string;
+    priority: NotificationPriority;
+    coalesce: boolean;
+}>;
+export interface FactoryReportSender {
+    sessionId: string;
+    threadId: string;
+    userId: string;
+}
+export type FactoryReportDeliver = (target: FactoryDeliveryTarget, notification: Omit<SendNotificationSignalInput, 'source'>, options?: {
+    onlyIfLive?: boolean;
+}) => Promise<FactoryDeliveryResult>;
+export interface FactoryReporting {
+    deliver: FactoryReportDeliver;
+    notifications: Pick<NotificationsStorage, 'listNotifications'>;
+}
+/**
+ * Whether `senderSessionId` already put a report of one of `kinds` on the
+ * recipient thread since `since`. Reads the durable notifications store, so it
+ * holds across restarts. `listNotifications` has no time filter: records come
+ * newest-updated first, and the scan stops at the first one last updated
+ * before `since` (nothing after it can have been created later).
+ */
+export declare function hasFinalReport(notifications: FactoryReporting['notifications'], { senderSessionId, recipientThreadId, since, kinds, agentOnly, }: {
+    senderSessionId: string;
+    recipientThreadId: string;
+    since: Date;
+    kinds: readonly string[];
+    /** Ignore reports Factory sent on the session's behalf (the backstop). */
+    agentOnly?: boolean;
+}): Promise<boolean>;
+export declare function reportNotification({ sender, status, message, attributes, }: {
+    sender: FactoryReportSender;
+    status?: FactoryReportStatus;
+    message: string;
+    attributes?: Record<string, string>;
+}): Omit<SendNotificationSignalInput, 'source'>;
+/** Everyone following a work item, except the session doing the reporting. */
+export declare function workItemReportRecipients(workItems: Pick<WorkItemsStorage, 'listWorkItemSubscribers'>, { orgId, workItemId, senderSessionId }: {
+    orgId: string;
+    workItemId: string;
+    senderSessionId: string;
+}): Promise<FactoryDeliveryTarget[]>;
+/** Attributes that say which item and role a worker's report is about. */
+export declare function workItemReportAttributes(workItems: Pick<WorkItemsStorage, 'getForProject'>, { orgId, factoryProjectId, workItemId, role, }: {
+    orgId: string;
+    factoryProjectId: string;
+    workItemId: string;
+    role: string;
+}): Promise<{
+    label: string;
+    attributes: Record<string, string>;
+}>;
+export type FactoryRunOutcome = {
+    status: 'done';
+} | {
+    status: 'failed';
+    reason: string;
+    failureCode?: string;
+} | {
+    status: 'blocked';
+    toolName?: string;
+    approval?: boolean;
+};
+/** `waiting`: the session is waiting for an answer, so a later run owes the final report. */
+export interface FactoryRunEndResult {
+    waiting: boolean;
+    deliveries?: FactoryDeliveryResult[];
+}
+/**
+ * The run-end backstop: send `outcome` to each recipient that hasn't had a
+ * final report from this sender since the run started. An agent's own `done`
+ * or `failed` report wins. A run that completes after the agent's own
+ * `blocked` sends nothing: the agent ended its turn to wait for an answer, and
+ * its `done` comes from a later run. A `failed` backstop still goes out after an
+ * earlier `blocked`.
+ */
+export declare function sendRunEndReport(reporting: FactoryReporting, { sender, recipients, since, outcome, subject, attributes, }: {
+    sender: FactoryReportSender;
+    recipients: FactoryDeliveryTarget[];
+    since: Date;
+    outcome: FactoryRunOutcome;
+    /** Who finished, e.g. "The work session for #12". */
+    subject: string;
+    attributes?: Record<string, string>;
+}): Promise<FactoryRunEndResult>;
+export interface FactoryRunEndInput {
+    orgId: string;
+    factoryProjectId: string;
+    workItemId: string;
+    role: string;
+    sender: FactoryReportSender;
+    since: Date;
+    outcome: FactoryRunOutcome;
+}
+export type FactoryRunEndReporter = (input: FactoryRunEndInput) => Promise<FactoryRunEndResult>;
+/** The backstop for a work-item run: reports to the item's subscribers. Failures are logged, never thrown. */
+export declare function createWorkItemRunEndReporter({ workItems, reporting, }: {
+    workItems: Pick<WorkItemsStorage, 'listWorkItemSubscribers' | 'getForProject'>;
+    /** Resolved per report: the controller exists only once the mount is up. */
+    reporting: () => Promise<FactoryReporting | null>;
+}): FactoryRunEndReporter;
+export interface FactoryStageChange {
+    orgId: string;
+    factoryProjectId: string;
+    workItemId: string;
+    fromStage: string | undefined;
+    toStage: string;
+}
+/**
+ * Tells a work item's subscribers it moved, at `low` priority. Only sessions
+ * already live hear it: a stage change never brings a session online; an
+ * offline subscriber sees the stage in its state signal on its next turn.
+ */
+export declare function createStageChangeNotifier({ workItems, reporting, }: {
+    workItems: Pick<WorkItemsStorage, 'listWorkItemSubscribers' | 'getForProject'>;
+    reporting: () => Promise<FactoryReporting | null>;
+}): (change: FactoryStageChange) => Promise<void>;
+/** Reports one run end of a session; the thread is the one the run used. */
+export type FactorySessionRunEndReporter = (input: {
+    sessionId: string;
+    threadId: string | null;
+    outcome: FactoryRunOutcome;
+    since: Date;
+}) => Promise<void>;
+/** A tool call a session's run is holding until someone approves or declines it. */
+export interface FactoryApprovalRequest {
+    sessionId: string;
+    threadId: string | null;
+    toolName: string;
+    toolCallId: string;
+    args: unknown;
+}
+export type FactoryApprovalNotifier = (request: FactoryApprovalRequest) => Promise<void>;
+interface SessionReportDependencies {
+    sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;
+    workItems: Pick<WorkItemsStorage, 'findActiveRunBindingForSession' | 'findRunBindingBySession' | 'listWorkItemSubscribers' | 'getForProject'>;
+    reporting: () => Promise<FactoryReporting | null>;
+}
+/** Reports each run end of a work or side session to whoever follows it. */
+export declare function createSessionRunEndReporter(deps: SessionReportDependencies): FactorySessionRunEndReporter;
+/**
+ * Tells whoever follows a session, urgently, the moment its run holds a tool
+ * call for approval. The run stays open on the gate, so no run end would say
+ * so; the notice names the session and call so a follower can answer it with
+ * `factory_answer_approval`.
+ */
+export declare function createSessionApprovalNotifier(deps: SessionReportDependencies): FactoryApprovalNotifier;
+export {};
+//# sourceMappingURL=reports.d.ts.map

package/dist/tools/reports.d.ts.map

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