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

package/dist/tools/sessions-state-processor.js

@@ -0,0 +1,206 @@
+import { boardForWorkItem } from "../boards/semantics.js";
+import "../boards/index.js";
+import { FACTORY_SESSION_NOTIFICATION_SOURCE } from "./deliver.js";
+import { workItemNumber } from "./read-tools.js";
+import { resolveFactoryToolScope } from "./scope.js";
+import { createHash } from "crypto";
+//#region src/tools/sessions-state-processor.ts
+const STATE_ID = "factory-sessions";
+/** Finished side sessions and items that reached a terminal stage drop out after this long. */
+const FACTORY_SESSIONS_MAX_AGE_MS = 1440 * 60 * 1e3;
+/** Rows shown before the rest collapse into "+N more". */
+const FACTORY_SESSIONS_MAX_ROWS = 20;
+const NOTIFICATION_SCAN = 100;
+const EMPTY_CACHE_KEY = "empty";
+function escapeText(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function cacheKeyFor(value) {
+	return `sessions:${createHash("sha256").update(JSON.stringify(value)).digest("hex").slice(0, 16)}`;
+}
+function report(record) {
+	return record ? {
+		kind: record.kind,
+		at: record.createdAt.toISOString()
+	} : null;
+}
+function newest(records, match) {
+	let found;
+	for (const record of records) if (match(record) && (!found || record.createdAt > found.createdAt)) found = record;
+	return found;
+}
+function itemLabel(item) {
+	const number = workItemNumber(item);
+	return number === null ? item.id : `#${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.
+*/
+var FactorySessionsStateProcessor = class {
+	id = STATE_ID;
+	stateId = STATE_ID;
+	#deps;
+	constructor(deps) {
+		this.#deps = deps;
+	}
+	async computeStateSignal(args) {
+		const scope = await resolveFactoryToolScope({
+			requestContext: args.requestContext,
+			authEnabled: this.#deps.authEnabled,
+			sessions: this.#deps.sessions,
+			projects: this.#deps.projects,
+			workItems: this.#deps.workItems
+		});
+		if (!scope) return;
+		const hasBase = Boolean(args.lastSnapshot) && args.contextWindow.hasSnapshot;
+		const previousKey = hasBase ? args.tracking?.currentCacheKey ?? (args.lastSnapshot?.metadata?.state)?.cacheKey : void 0;
+		const unchanged = (cacheKey) => previousKey === cacheKey;
+		const cleared = () => hasBase && previousKey !== void 0 && previousKey !== EMPTY_CACHE_KEY;
+		if (scope.kind === "worker") {
+			const contents = await this.#workerLine(scope);
+			if (!contents) return cleared() ? this.#signal(EMPTY_CACHE_KEY, "This session is not reporting on any work now.", {}, { entries: 0 }) : void 0;
+			const cacheKey = cacheKeyFor(contents);
+			if (unchanged(cacheKey)) return;
+			return this.#signal(cacheKey, escapeText(contents), { worker: contents }, { entries: 1 });
+		}
+		const state = await this.#userState(scope);
+		if (state.sideSessions.length === 0 && state.following.length === 0) {
+			if (!cleared()) return;
+			return this.#signal(EMPTY_CACHE_KEY, "No sub-sessions or followed work items.", state, { entries: 0 });
+		}
+		const cacheKey = cacheKeyFor(state);
+		if (unchanged(cacheKey)) return;
+		return this.#signal(cacheKey, this.#render(state), state, {
+			sideSessions: state.sideSessions.length,
+			following: state.following.length
+		});
+	}
+	#signal(cacheKey, contents, value, attributes) {
+		return {
+			id: STATE_ID,
+			cacheKey,
+			mode: "snapshot",
+			tagName: "factory-sessions",
+			contents,
+			value: { sessions: value },
+			attributes,
+			metadata: { value: { sessions: value } }
+		};
+	}
+	async #workerLine(scope) {
+		if (scope.origin) return `Started by session ${scope.origin.sessionId} (thread ${scope.origin.threadId}). Report back with factory_message_origin.`;
+		const binding = await this.#deps.workItems.findActiveRunBindingForSession({
+			orgId: scope.orgId,
+			factoryProjectId: scope.factoryProjectId,
+			sessionId: scope.sessionId
+		});
+		if (!binding) return null;
+		const item = await this.#deps.workItems.getForProject(scope.orgId, scope.factoryProjectId, binding.workItemId);
+		const following = (await this.#deps.workItems.listWorkItemSubscribers({
+			orgId: scope.orgId,
+			workItemId: binding.workItemId
+		})).filter((subscriber) => subscriber.sessionId !== scope.sessionId).length;
+		if (following === 0) return null;
+		return `Working on ${item ? itemLabel(item) : binding.workItemId} as ${binding.role}. Reports go to ${following} following session${following === 1 ? "" : "s"}.`;
+	}
+	async #userState(scope) {
+		const now = this.#deps.now?.() ?? Date.now();
+		const notifications = await this.#deps.notifications();
+		const records = notifications ? await notifications.listNotifications({
+			threadId: scope.threadId,
+			source: FACTORY_SESSION_NOTIFICATION_SOURCE,
+			limit: NOTIFICATION_SCAN
+		}) : [];
+		const sideRows = await this.#deps.sessions.listByOrigin({
+			orgId: scope.orgId,
+			originSessionId: scope.sessionId
+		});
+		const sideSessions = [];
+		for (const row of sideRows) {
+			if (row.factoryProjectId !== scope.factoryProjectId) continue;
+			const last = newest(records, (record) => record.attributes?.["from-session"] === row.sessionId);
+			const running = await this.#deps.isRunning(row.sessionId);
+			const lastActivity = last?.createdAt.getTime() ?? row.updatedAt.getTime();
+			if (!running && now - lastActivity > 864e5) continue;
+			const state = running ? "running" : last?.kind === "blocked" ? "parked" : "idle";
+			sideSessions.push({
+				sessionId: row.sessionId,
+				title: row.title ?? row.sessionId,
+				state,
+				lastReport: report(last),
+				active: state !== "idle"
+			});
+		}
+		const subscriptions = await this.#deps.workItems.listSessionSubscriptions({
+			orgId: scope.orgId,
+			factoryProjectId: scope.factoryProjectId,
+			sessionId: scope.sessionId
+		});
+		const following = [];
+		for (const subscription of subscriptions) {
+			const item = await this.#deps.workItems.getForProject(scope.orgId, scope.factoryProjectId, subscription.workItemId);
+			if (!item) continue;
+			const stage = item.stages[0] ?? "unknown";
+			const terminal = this.#deps.boards.get(boardForWorkItem(item))?.isTerminal(stage) ?? false;
+			if (terminal && now - item.updatedAt.getTime() > 864e5) continue;
+			const active = (await this.#deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id)).find((binding) => binding.status === "active");
+			const label = itemLabel(item);
+			const last = newest(records, (record) => record.attributes?.["work-item"] === label || record.kind === "stage" && record.sourceId === item.id);
+			const running = active ? await this.#deps.isRunning(active.sessionId) : false;
+			const lastFromWorker = active ? newest(records, (record) => record.attributes?.["from-session"] === active.sessionId) : void 0;
+			following.push({
+				workItemId: item.id,
+				label,
+				title: item.title,
+				stage,
+				worker: active ? {
+					role: active.role,
+					sessionId: active.sessionId,
+					state: running ? "running" : lastFromWorker?.kind === "blocked" ? "parked" : "idle"
+				} : null,
+				lastReport: report(last),
+				active: running && !terminal
+			});
+		}
+		const ordered = [...sideSessions.map((row) => ({
+			section: "side",
+			row
+		})), ...following.map((row) => ({
+			section: "following",
+			row
+		}))].sort((a, b) => Number(b.row.active) - Number(a.row.active));
+		const shown = ordered.slice(0, 20);
+		const strip = ({ active: _active, ...row }) => row;
+		return {
+			sideSessions: shown.flatMap((entry) => entry.section === "side" ? [strip(entry.row)] : []),
+			following: shown.flatMap((entry) => entry.section === "following" ? [strip(entry.row)] : []),
+			more: ordered.length - shown.length
+		};
+	}
+	#render(state) {
+		const lastReport = (last) => last ? `; last report ${last.kind} at ${last.at}` : "";
+		const lines = [];
+		if (state.sideSessions.length > 0) {
+			lines.push("Side sessions you started:");
+			for (const row of state.sideSessions) lines.push(`- "${escapeText(row.title)}" (session ${row.sessionId}): ${row.state}${lastReport(row.lastReport)}`);
+		}
+		if (state.following.length > 0) {
+			lines.push("Work items you follow:");
+			for (const row of state.following) {
+				const worker = row.worker ? `; ${escapeText(row.worker.role)} session ${row.worker.sessionId} ${row.worker.state}` : "";
+				lines.push(`- ${escapeText(row.label)} "${escapeText(row.title)}": ${escapeText(row.stage)}${worker}${lastReport(row.lastReport)}`);
+			}
+		}
+		if (state.more > 0) lines.push(`+${state.more} more`);
+		lines.push("Message any of these sessions with factory_signal_session; read full reports with notification_inbox.");
+		return lines.join("\n");
+	}
+};
+//#endregion
+export { FACTORY_SESSIONS_MAX_AGE_MS, FACTORY_SESSIONS_MAX_ROWS, FactorySessionsStateProcessor };
+
+//# sourceMappingURL=sessions-state-processor.js.map

package/dist/tools/sessions-state-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-state-processor.js","names":["#deps","#workerLine","#signal","#userState","#render"],"sources":["../../src/tools/sessions-state-processor.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport type { NotificationRecord, NotificationsStorage } from '@mastra/core/notifications';\nimport type { ComputeStateSignalArgs, ComputeStateSignalResult, Processor } from '@mastra/core/processors';\n\nimport { boardForWorkItem } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/registry.js';\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { FACTORY_SESSION_NOTIFICATION_SOURCE } from './deliver.js';\nimport { workItemNumber } from './read-tools.js';\nimport { resolveFactoryToolScope } from './scope.js';\nimport type { FactoryToolScope, ResolveFactoryToolScopeOptions } from './scope.js';\n\nconst STATE_ID = 'factory-sessions';\n/** Finished side sessions and items that reached a terminal stage drop out after this long. */\nexport const FACTORY_SESSIONS_MAX_AGE_MS = 24 * 60 * 60 * 1000;\n/** Rows shown before the rest collapse into \"+N more\". */\nexport const FACTORY_SESSIONS_MAX_ROWS = 20;\nconst NOTIFICATION_SCAN = 100;\nconst EMPTY_CACHE_KEY = 'empty';\n\nexport type FactorySessionRunState = 'running' | 'idle' | 'parked';\n\nexport interface FactorySessionsStateDependencies {\n  authEnabled: boolean;\n  sessions: Pick<SourceControlSessionLookup, 'getBySessionId' | 'listByOrigin'>;\n  projects: ResolveFactoryToolScopeOptions['projects'];\n  workItems: Pick<\n    WorkItemsStorage,\n    | 'hasRunBindingForSession'\n    | 'listSessionSubscriptions'\n    | 'getForProject'\n    | 'listRunBindings'\n    | 'findActiveRunBindingForSession'\n    | 'listWorkItemSubscribers'\n  >;\n  boards: BoardRegistry;\n  /** Whether the session's agent is mid-run in this process; `idle` when it isn't live here. */\n  isRunning: (sessionId: string) => Promise<boolean>;\n  notifications: () => Promise<Pick<NotificationsStorage, 'listNotifications'> | null>;\n  now?: () => number;\n}\n\ninterface LastReport {\n  kind: string;\n  at: string;\n}\n\ninterface SideSessionRow {\n  sessionId: string;\n  title: string;\n  state: FactorySessionRunState;\n  lastReport: LastReport | null;\n}\n\ninterface FollowedRow {\n  workItemId: string;\n  label: string;\n  title: string;\n  stage: string;\n  worker: { role: string; sessionId: string; state: FactorySessionRunState } | null;\n  lastReport: LastReport | null;\n}\n\ninterface SessionsState {\n  sideSessions: SideSessionRow[];\n  following: FollowedRow[];\n  more: number;\n}\n\nfunction escapeText(value: string): string {\n  return value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');\n}\n\nfunction cacheKeyFor(value: unknown): string {\n  return `sessions:${createHash('sha256').update(JSON.stringify(value)).digest('hex').slice(0, 16)}`;\n}\n\nfunction report(record: NotificationRecord | undefined): LastReport | null {\n  return record ? { kind: record.kind, at: record.createdAt.toISOString() } : null;\n}\n\nfunction newest(records: NotificationRecord[], match: (record: NotificationRecord) => boolean) {\n  let found: NotificationRecord | undefined;\n  for (const record of records) {\n    if (match(record) && (!found || record.createdAt > found.createdAt)) found = record;\n  }\n  return found;\n}\n\nfunction itemLabel(item: WorkItemRow): string {\n  const number = workItemNumber(item);\n  return number === null ? item.id : `#${number}`;\n}\n\n/**\n * The `<factory-sessions>` state signal. A user session sees the side sessions\n * it started and the work items it follows; a side session or item worker sees\n * who it reports to. Sessions it only messaged never appear. Silent until there\n * is something to show; when the last entry ages out it sends one final empty\n * snapshot, then stays silent.\n */\nexport class FactorySessionsStateProcessor implements Processor<'factory-sessions'> {\n  readonly id = STATE_ID;\n  readonly stateId = STATE_ID;\n  readonly #deps: FactorySessionsStateDependencies;\n\n  constructor(deps: FactorySessionsStateDependencies) {\n    this.#deps = deps;\n  }\n\n  async computeStateSignal(args: ComputeStateSignalArgs): Promise<ComputeStateSignalResult> {\n    const scope = await resolveFactoryToolScope({\n      requestContext: args.requestContext!,\n      authEnabled: this.#deps.authEnabled,\n      sessions: this.#deps.sessions,\n      projects: this.#deps.projects,\n      workItems: this.#deps.workItems,\n    });\n    if (!scope) return;\n\n    const hasBase = Boolean(args.lastSnapshot) && args.contextWindow.hasSnapshot;\n    const previousKey = hasBase\n      ? (args.tracking?.currentCacheKey ?? (args.lastSnapshot?.metadata?.state as { cacheKey?: string })?.cacheKey)\n      : undefined;\n    const unchanged = (cacheKey: string) => previousKey === cacheKey;\n    // Silence rule: one final empty snapshot replaces a non-empty one, then nothing.\n    const cleared = () => hasBase && previousKey !== undefined && previousKey !== EMPTY_CACHE_KEY;\n\n    if (scope.kind === 'worker') {\n      const contents = await this.#workerLine(scope);\n      if (!contents) {\n        return cleared()\n          ? this.#signal(EMPTY_CACHE_KEY, 'This session is not reporting on any work now.', {}, { entries: 0 })\n          : undefined;\n      }\n      const cacheKey = cacheKeyFor(contents);\n      if (unchanged(cacheKey)) return;\n      return this.#signal(cacheKey, escapeText(contents), { worker: contents }, { entries: 1 });\n    }\n\n    const state = await this.#userState(scope);\n    if (state.sideSessions.length === 0 && state.following.length === 0) {\n      if (!cleared()) return;\n      return this.#signal(EMPTY_CACHE_KEY, 'No sub-sessions or followed work items.', state, { entries: 0 });\n    }\n    const cacheKey = cacheKeyFor(state);\n    if (unchanged(cacheKey)) return;\n    return this.#signal(cacheKey, this.#render(state), state, {\n      sideSessions: state.sideSessions.length,\n      following: state.following.length,\n    });\n  }\n\n  #signal(cacheKey: string, contents: string, value: unknown, attributes: Record<string, number>) {\n    return {\n      id: STATE_ID,\n      cacheKey,\n      mode: 'snapshot' as const,\n      tagName: 'factory-sessions',\n      contents,\n      value: { sessions: value },\n      attributes,\n      metadata: { value: { sessions: value } },\n    };\n  }\n\n  async #workerLine(scope: FactoryToolScope): Promise<string | null> {\n    if (scope.origin) {\n      return `Started by session ${scope.origin.sessionId} (thread ${scope.origin.threadId}). Report back with factory_message_origin.`;\n    }\n    const binding = await this.#deps.workItems.findActiveRunBindingForSession({\n      orgId: scope.orgId,\n      factoryProjectId: scope.factoryProjectId,\n      sessionId: scope.sessionId,\n    });\n    if (!binding) return null;\n    const item = await this.#deps.workItems.getForProject(scope.orgId, scope.factoryProjectId, binding.workItemId);\n    const subscribers = await this.#deps.workItems.listWorkItemSubscribers({\n      orgId: scope.orgId,\n      workItemId: binding.workItemId,\n    });\n    const following = subscribers.filter(subscriber => subscriber.sessionId !== scope.sessionId).length;\n    // Nobody to report to: nothing worth showing (most board-started workers).\n    if (following === 0) return null;\n    const label = item ? itemLabel(item) : binding.workItemId;\n    return `Working on ${label} as ${binding.role}. Reports go to ${following} following session${following === 1 ? '' : 's'}.`;\n  }\n\n  async #userState(scope: FactoryToolScope): Promise<SessionsState> {\n    const now = this.#deps.now?.() ?? Date.now();\n    const notifications = await this.#deps.notifications();\n    const records = notifications\n      ? await notifications.listNotifications({\n          threadId: scope.threadId,\n          source: FACTORY_SESSION_NOTIFICATION_SOURCE,\n          limit: NOTIFICATION_SCAN,\n        })\n      : [];\n\n    const sideRows = await this.#deps.sessions.listByOrigin({ orgId: scope.orgId, originSessionId: scope.sessionId });\n    const sideSessions: Array<SideSessionRow & { active: boolean }> = [];\n    for (const row of sideRows) {\n      if (row.factoryProjectId !== scope.factoryProjectId) continue;\n      const last = newest(records, record => record.attributes?.['from-session'] === row.sessionId);\n      const running = await this.#deps.isRunning(row.sessionId);\n      const lastActivity = last?.createdAt.getTime() ?? row.updatedAt.getTime();\n      if (!running && now - lastActivity > FACTORY_SESSIONS_MAX_AGE_MS) continue;\n      const state: FactorySessionRunState = running ? 'running' : last?.kind === 'blocked' ? 'parked' : 'idle';\n      sideSessions.push({\n        sessionId: row.sessionId,\n        title: row.title ?? row.sessionId,\n        state,\n        lastReport: report(last),\n        active: state !== 'idle',\n      });\n    }\n\n    const subscriptions = await this.#deps.workItems.listSessionSubscriptions({\n      orgId: scope.orgId,\n      factoryProjectId: scope.factoryProjectId,\n      sessionId: scope.sessionId,\n    });\n    const following: Array<FollowedRow & { active: boolean }> = [];\n    for (const subscription of subscriptions) {\n      const item = await this.#deps.workItems.getForProject(\n        scope.orgId,\n        scope.factoryProjectId,\n        subscription.workItemId,\n      );\n      if (!item) continue;\n      const stage = item.stages[0] ?? 'unknown';\n      const terminal = this.#deps.boards.get(boardForWorkItem(item))?.isTerminal(stage) ?? false;\n      if (terminal && now - item.updatedAt.getTime() > FACTORY_SESSIONS_MAX_AGE_MS) continue;\n      const bindings = await this.#deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id);\n      const active = bindings.find(binding => binding.status === 'active');\n      const label = itemLabel(item);\n      const last = newest(\n        records,\n        record =>\n          record.attributes?.['work-item'] === label || (record.kind === 'stage' && record.sourceId === item.id),\n      );\n      const running = active ? await this.#deps.isRunning(active.sessionId) : false;\n      const lastFromWorker = active\n        ? newest(records, record => record.attributes?.['from-session'] === active.sessionId)\n        : undefined;\n      following.push({\n        workItemId: item.id,\n        label,\n        title: item.title,\n        stage,\n        worker: active\n          ? {\n              role: active.role,\n              sessionId: active.sessionId,\n              state: running ? 'running' : lastFromWorker?.kind === 'blocked' ? 'parked' : 'idle',\n            }\n          : null,\n        lastReport: report(last),\n        active: running && !terminal,\n      });\n    }\n\n    // Active entries first, then within the cap; the rest collapse into \"+N more\".\n    const ordered = [\n      ...sideSessions.map(row => ({ section: 'side' as const, row })),\n      ...following.map(row => ({ section: 'following' as const, row })),\n    ].sort((a, b) => Number(b.row.active) - Number(a.row.active));\n    const shown = ordered.slice(0, FACTORY_SESSIONS_MAX_ROWS);\n    const strip = <T extends { active: boolean }>({ active: _active, ...row }: T) => row;\n    return {\n      sideSessions: shown.flatMap(entry =>\n        entry.section === 'side' ? [strip(entry.row as SideSessionRow & { active: boolean })] : [],\n      ),\n      following: shown.flatMap(entry =>\n        entry.section === 'following' ? [strip(entry.row as FollowedRow & { active: boolean })] : [],\n      ),\n      more: ordered.length - shown.length,\n    };\n  }\n\n  #render(state: SessionsState): string {\n    const lastReport = (last: LastReport | null) => (last ? `; last report ${last.kind} at ${last.at}` : '');\n    const lines: string[] = [];\n    if (state.sideSessions.length > 0) {\n      lines.push('Side sessions you started:');\n      for (const row of state.sideSessions) {\n        lines.push(\n          `- \"${escapeText(row.title)}\" (session ${row.sessionId}): ${row.state}${lastReport(row.lastReport)}`,\n        );\n      }\n    }\n    if (state.following.length > 0) {\n      lines.push('Work items you follow:');\n      for (const row of state.following) {\n        const worker = row.worker\n          ? `; ${escapeText(row.worker.role)} session ${row.worker.sessionId} ${row.worker.state}`\n          : '';\n        lines.push(\n          `- ${escapeText(row.label)} \"${escapeText(row.title)}\": ${escapeText(row.stage)}${worker}${lastReport(row.lastReport)}`,\n        );\n      }\n    }\n    if (state.more > 0) lines.push(`+${state.more} more`);\n    lines.push('Message any of these sessions with factory_signal_session; read full reports with notification_inbox.');\n    return lines.join('\\n');\n  }\n}\n"],"mappings":"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"}

package/dist/tools/work-item-tools.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Factory tools that change work items: file one, move it, settle its
+ * decisions, and follow it. They act as the session's person (a human actor),
+ * through the same code the board's routes use.
+ */
+import type { BoardRegistry } from '../boards/index.js';
+import type { IntegrationTools } from '../integrations/base.js';
+import type { FactoryTransitionService } from '../rules/transition-service.js';
+import type { SourceControlSessionLookup } from '../session/factory-session.js';
+import type { AuditRecorder } from '../storage/domains/audit/domain.js';
+import type { CommentsDomain } from '../storage/domains/comments/domain.js';
+import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
+import type { FactoryToolScope } from './scope.js';
+export interface FactoryWorkItemToolDependencies {
+    workItems: WorkItemsStorage;
+    boards: BoardRegistry;
+    /** Governed stage moves; filing and moving items refuse while it is unavailable. */
+    transitionService: Pick<FactoryTransitionService, 'transition'> | undefined;
+    /** Writes audit rows with an explicit actor; tool calls have no HTTP request to read one from. */
+    auditRecorder: AuditRecorder;
+    /** The feed's front door: validates, touches open boards and mirrors to linked channels. */
+    feed: Pick<CommentsDomain, 'createComment'>;
+    /** Finds the caller session's source-control provider, whose linked repositories a card can name. */
+    sessions: Pick<SourceControlSessionLookup, 'getSourceControlBySessionId'>;
+}
+/** The work-item write and subscription tools for one user session's turn. */
+export declare function createFactoryWorkItemTools(scope: FactoryToolScope, deps: FactoryWorkItemToolDependencies): IntegrationTools;
+//# sourceMappingURL=work-item-tools.d.ts.map

package/dist/tools/work-item-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-tools.d.ts","sourceRoot":"","sources":["../../src/tools/work-item-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,OAAO,KAAK,EAAoC,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAkBhH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,oFAAoF;IACpF,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAC5E,kGAAkG;IAClG,aAAa,EAAE,aAAa,CAAC;IAC7B,4FAA4F;IAC5F,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAC5C,qGAAqG;IACrG,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,CAAC;CAC3E;AA2BD,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,+BAA+B,GACpC,gBAAgB,CA6RlB"}

package/dist/tools/work-item-tools.js

@@ -0,0 +1,322 @@
+import { boardForWorkItem } from "../boards/semantics.js";
+import "../boards/index.js";
+import { WorkItemRelationError } from "../storage/domains/work-items/base.js";
+import { findWorkItem, truncate, workItemNotFound, workItemNumber, workItemRefSchema, workItemStage } from "./read-tools.js";
+import { resolveWorkItemRepository } from "../session/work-item-repository.js";
+import { transitionBodySchema } from "../routes/contracts.js";
+import { createFactoryWorkItem } from "../work-items/create-work-item.js";
+import { dismissFactoryDecision, resolveFactoryProposal, retryFactoryDecision } from "../work-items/decision-actions.js";
+import { randomUUID } from "crypto";
+import { z } from "zod";
+import { createTool } from "@mastra/core/tools";
+//#region src/tools/work-item-tools.ts
+/**
+* Factory tools that change work items: file one, move it, settle its
+* decisions, and follow it. They act as the session's person (a human actor),
+* through the same code the board's routes use.
+*/
+const repositorySchema = z.string().trim().min(3).max(200).regex(/^[^/\s]+\/[^/\s]+$/, "Use the owner/name form, e.g. \"mastra-ai/mastra\".").describe("A repository linked to this Factory, as owner/name.");
+const decisionId = z.string().trim().uuid().describe("Decision id, from factory_list_attention or inspect.");
+function briefItem(item) {
+	return {
+		id: item.id,
+		number: workItemNumber(item),
+		title: truncate(item.title, 600),
+		stage: workItemStage(item)
+	};
+}
+function settled(result) {
+	if (!result.ok) throw new Error(result.message);
+	const { decision } = result;
+	return {
+		decisionId: decision.id,
+		status: decision.status,
+		workItemId: decision.workItemId
+	};
+}
+/** The work-item write and subscription tools for one user session's turn. */
+function createFactoryWorkItemTools(scope, deps) {
+	const project = {
+		orgId: scope.orgId,
+		factoryProjectId: scope.factoryProjectId
+	};
+	const audit = async (input) => {
+		await deps.auditRecorder.record({
+			orgId: scope.orgId,
+			actorId: scope.userId,
+			actorType: "human",
+			...scope.actorProfile ? { actorProfile: scope.actorProfile } : {},
+			...input
+		});
+	};
+	const requireItem = async (ref) => {
+		const item = await findWorkItem(deps.workItems, scope, ref);
+		if (!item) throw workItemNotFound(ref);
+		return item;
+	};
+	/**
+	* Check `slug` is a repository linked to this Factory and that a card with
+	* `metadata` would run in it (a card synced from an issue follows the
+	* issue's repository, which a slug can't override).
+	*/
+	const requireRepository = async (slug, metadata = null) => {
+		const sourceControl = await deps.sessions.getSourceControlBySessionId(scope.sessionId);
+		if (!sourceControl) throw new Error("This session has no source-control provider to look repositories up in.");
+		const resolve = (repository) => resolveWorkItemRepository({
+			sourceControl,
+			...project,
+			item: { metadata: repository ? {
+				...metadata,
+				repository
+			} : metadata }
+		});
+		const resolution = await resolve(slug);
+		if (resolution.status === "resolved" && resolution.slug === slug) return;
+		if (resolution.status === "resolved") throw new Error(`This card runs in ${resolution.slug}, which comes from its linked issue and can't be changed.`);
+		const linked = await resolve();
+		const candidates = linked.status === "ambiguous" ? linked.candidates : linked.status === "resolved" ? [linked.slug] : [];
+		throw new Error(candidates.length > 0 ? `${slug} is not linked to this Factory. Linked repositories: ${candidates.join(", ")}.` : `${slug} is not linked to this Factory, and it has no linked repositories.`);
+	};
+	const follow = (item, reason) => deps.workItems.subscribeToWorkItem({
+		...project,
+		workItemId: item.id,
+		sessionId: scope.sessionId,
+		threadId: scope.threadId,
+		resourceId: scope.resourceId,
+		userId: scope.userId,
+		reason
+	});
+	return {
+		factory_create_work_item: createTool({
+			id: "factory_create_work_item",
+			description: "File a new work item on this Factory's Work board for the person you are working with. It lands in the board's first phase, exactly like pressing New card, and this session follows it. Check factory_list_work_items for an existing item first. Name the repository when the Factory links more than one; runs refuse to start on a card that doesn't say which.",
+			inputSchema: z.object({
+				title: z.string().trim().min(1).max(512).describe("Short title, as it should read on the card."),
+				brief: z.string().trim().min(1).max(8e3).describe("What needs doing and why; posted as the first comment on the card."),
+				repository: repositorySchema.optional()
+			}).strict(),
+			execute: async ({ title, brief, repository }) => {
+				if (repository) await requireRepository(repository);
+				const created = await createFactoryWorkItem({
+					workItems: deps.workItems,
+					boards: deps.boards,
+					transitionService: deps.transitionService,
+					audit,
+					...project,
+					userId: scope.userId,
+					...scope.actorProfile ? { origin: { actorProfile: scope.actorProfile } } : {},
+					input: {
+						title,
+						...repository ? { metadata: { repository } } : {}
+					}
+				});
+				if (created.status === "refused") throw new Error(created.message);
+				if (created.status === "rejected") throw new Error(`The board refused the new item: ${created.reason}`);
+				const { item } = created;
+				const warnings = [];
+				try {
+					const comment = await deps.feed.createComment({
+						orgId: scope.orgId,
+						workItemId: item.id,
+						author: {
+							kind: "user",
+							id: scope.userId
+						},
+						body: brief
+					});
+					if (comment.status !== "created") warnings.push(`The brief was not posted (${comment.status === "invalid" ? comment.message : comment.status}).`);
+				} catch (error) {
+					warnings.push(`The brief was not posted: ${error instanceof Error ? error.message : String(error)}`);
+				}
+				try {
+					await follow(item, "created");
+				} catch (error) {
+					warnings.push(`This session does not follow it yet: ${error instanceof Error ? error.message : String(error)}`);
+				}
+				return warnings.length ? {
+					...briefItem(item),
+					warnings
+				} : briefItem(item);
+			}
+		}),
+		factory_transition_work_item: createTool({
+			id: "factory_transition_work_item",
+			description: "Move a work item to another stage of its board, as the person you are working with. The board's rules decide whether the move is allowed and what it starts.",
+			inputSchema: z.object({
+				workItem: workItemRefSchema,
+				stage: z.string().trim().min(1).max(64).describe("Destination stage, e.g. \"planning\" or \"done\".")
+			}).strict(),
+			execute: async ({ workItem, stage }) => {
+				if (!deps.transitionService) throw new Error("Factory stage transitions are not available right now.");
+				const item = await requireItem(workItem);
+				const parsed = transitionBodySchema.safeParse({
+					board: boardForWorkItem(item),
+					stage,
+					expectedRevision: item.revision,
+					requestId: randomUUID(),
+					cause: "factory_tools"
+				});
+				if (!parsed.success) throw new Error(`"${stage}" is not a valid stage name.`);
+				const result = await deps.transitionService.transition({
+					...parsed.data,
+					...project,
+					workItemId: item.id,
+					actor: {
+						type: "human",
+						id: scope.userId
+					},
+					...scope.actorProfile ? { actorProfile: scope.actorProfile } : {},
+					ingress: {
+						...parsed.data.ingress,
+						identity: `human:${scope.userId}:${parsed.data.ingress.identity}`
+					}
+				});
+				if (result.status === "rejected") throw new Error(`The move was refused (${result.code}): ${result.reason}`);
+				return {
+					workItemId: item.id,
+					stage: result.stage,
+					revision: result.revision
+				};
+			}
+		}),
+		factory_update_work_item: createTool({
+			id: "factory_update_work_item",
+			description: "Edit a work item's fields as the person you are working with: its title, the repository its runs use, its parent item, or pre-approving its plans. Move stages with factory_transition_work_item and start roles with factory_start_session; post to the card's feed for anything else.",
+			inputSchema: z.object({
+				workItem: workItemRefSchema,
+				title: z.string().trim().min(1).max(500).optional().describe("New card title."),
+				repository: repositorySchema.optional(),
+				parentWorkItem: workItemRefSchema.nullable().optional().describe("Parent work item (id or #number), or null to detach it from its parent."),
+				plansPreapproved: z.literal(true).optional().describe("Pre-approve the item's plans, so its runs no longer stop for plan approval. Can't be undone here.")
+			}).strict().refine((input) => Object.keys(input).some((key) => key !== "workItem"), "Pass at least one field to change."),
+			execute: async ({ workItem, title, repository, parentWorkItem, plansPreapproved }) => {
+				const item = await requireItem(workItem);
+				if (repository) await requireRepository(repository, item.metadata);
+				let parentWorkItemId;
+				if (parentWorkItem === null) parentWorkItemId = null;
+				else if (parentWorkItem !== void 0) parentWorkItemId = (await requireItem(parentWorkItem)).id;
+				const patch = {
+					...title !== void 0 ? { title } : {},
+					...repository ? { metadata: { repository } } : {},
+					...parentWorkItemId !== void 0 ? { parentWorkItemId } : {},
+					...plansPreapproved ? { plansPreapproved } : {}
+				};
+				let updated;
+				try {
+					updated = await deps.workItems.update({
+						orgId: scope.orgId,
+						id: item.id,
+						userId: scope.userId,
+						patch
+					});
+				} catch (error) {
+					if (error instanceof WorkItemRelationError) throw new Error(`The parent was refused: ${error.message}`);
+					throw error;
+				}
+				if (!updated) throw workItemNotFound(workItem);
+				const fields = [
+					...title !== void 0 ? ["title"] : [],
+					...repository ? ["metadata"] : [],
+					...parentWorkItemId !== void 0 ? ["parentWorkItemId"] : [],
+					...plansPreapproved ? ["plansPreapproved"] : []
+				];
+				await audit({
+					action: "factory.work_item.updated",
+					factoryProjectId: scope.factoryProjectId,
+					targets: [{
+						type: "work_item",
+						id: updated.item.id,
+						name: updated.item.title
+					}],
+					metadata: {
+						fields,
+						cause: "factory_tools"
+					}
+				});
+				const metadata = updated.item.metadata ?? {};
+				return {
+					workItem: briefItem(updated.item),
+					updated: fields.map((field) => field === "metadata" ? "repository" : field),
+					repository: typeof metadata.repository === "string" ? metadata.repository : null,
+					parentWorkItemId: updated.item.parentWorkItemId,
+					plansPreapproved: updated.item.plansPreapprovedAt !== null
+				};
+			}
+		}),
+		factory_retry_decision: createTool({
+			id: "factory_retry_decision",
+			description: "Retry one failed Factory run once its cause is fixed. Refused when the failure cannot be fixed by retrying or the item has moved on.",
+			inputSchema: z.object({ decisionId }).strict(),
+			execute: async ({ decisionId }) => settled(await retryFactoryDecision({
+				workItems: deps.workItems,
+				boards: deps.boards,
+				...project,
+				decisionId
+			}))
+		}),
+		factory_dismiss_decision: createTool({
+			id: "factory_dismiss_decision",
+			description: "Dismiss one proposed Factory run that is no longer wanted.",
+			inputSchema: z.object({ decisionId }).strict(),
+			execute: async ({ decisionId }) => settled(await dismissFactoryDecision({
+				workItems: deps.workItems,
+				audit,
+				...project,
+				userId: scope.userId,
+				decisionId
+			}))
+		}),
+		factory_resolve_proposal: createTool({
+			id: "factory_resolve_proposal",
+			description: "Approve or dismiss one proposed Factory run. Approving starts the run and lets the item's later runs start without asking.",
+			inputSchema: z.object({
+				decisionId,
+				action: z.enum(["approve", "dismiss"])
+			}).strict(),
+			execute: async ({ decisionId, action }) => settled(await resolveFactoryProposal({
+				workItems: deps.workItems,
+				audit,
+				...project,
+				userId: scope.userId,
+				decisionId,
+				action
+			}))
+		}),
+		factory_subscribe_work_item: createTool({
+			id: "factory_subscribe_work_item",
+			description: "Follow a work item from this session, so you hear about its progress and its sessions report to you. Items you file or start are followed already.",
+			inputSchema: z.object({ workItem: workItemRefSchema }).strict(),
+			execute: async ({ workItem }) => {
+				const item = await requireItem(workItem);
+				const subscription = await follow(item, "subscribed");
+				return {
+					workItem: briefItem(item),
+					subscribed: true,
+					reason: subscription.reason
+				};
+			}
+		}),
+		factory_unsubscribe_work_item: createTool({
+			id: "factory_unsubscribe_work_item",
+			description: "Stop following a work item from this session.",
+			inputSchema: z.object({ workItem: workItemRefSchema }).strict(),
+			execute: async ({ workItem }) => {
+				const item = await requireItem(workItem);
+				const removed = await deps.workItems.unsubscribeFromWorkItem({
+					orgId: scope.orgId,
+					workItemId: item.id,
+					sessionId: scope.sessionId
+				});
+				return {
+					workItem: briefItem(item),
+					subscribed: false,
+					wasSubscribed: removed
+				};
+			}
+		})
+	};
+}
+//#endregion
+export { createFactoryWorkItemTools };
+
+//# sourceMappingURL=work-item-tools.js.map

package/dist/tools/work-item-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-tools.js","names":[],"sources":["../../src/tools/work-item-tools.ts"],"sourcesContent":["/**\n * Factory tools that change work items: file one, move it, settle its\n * decisions, and follow it. They act as the session's person (a human actor),\n * through the same code the board's routes use.\n */\n\nimport { randomUUID } from 'node:crypto';\nimport { 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 { transitionBodySchema } from '../routes/contracts.js';\nimport type { FactoryTransitionService } from '../rules/transition-service.js';\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport { resolveWorkItemRepository } from '../session/work-item-repository.js';\nimport type { AuditRecorder } from '../storage/domains/audit/domain.js';\nimport type { CommentsDomain } from '../storage/domains/comments/domain.js';\nimport { WorkItemRelationError } from '../storage/domains/work-items/base.js';\nimport type { UpdateWorkItemInput, WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { createFactoryWorkItem } from '../work-items/create-work-item.js';\nimport type { FactoryAuditEmit } from '../work-items/create-work-item.js';\nimport {\n  dismissFactoryDecision,\n  resolveFactoryProposal,\n  retryFactoryDecision,\n} from '../work-items/decision-actions.js';\nimport type { FactoryDecisionActionResult } from '../work-items/decision-actions.js';\nimport {\n  MAX_TEXT,\n  findWorkItem,\n  workItemRefSchema,\n  truncate,\n  workItemNotFound,\n  workItemNumber,\n  workItemStage,\n} from './read-tools.js';\nimport type { FactoryToolScope } from './scope.js';\n\nexport interface FactoryWorkItemToolDependencies {\n  workItems: WorkItemsStorage;\n  boards: BoardRegistry;\n  /** Governed stage moves; filing and moving items refuse while it is unavailable. */\n  transitionService: Pick<FactoryTransitionService, 'transition'> | undefined;\n  /** Writes audit rows with an explicit actor; tool calls have no HTTP request to read one from. */\n  auditRecorder: AuditRecorder;\n  /** The feed's front door: validates, touches open boards and mirrors to linked channels. */\n  feed: Pick<CommentsDomain, 'createComment'>;\n  /** Finds the caller session's source-control provider, whose linked repositories a card can name. */\n  sessions: Pick<SourceControlSessionLookup, 'getSourceControlBySessionId'>;\n}\n\nconst repositorySchema = z\n  .string()\n  .trim()\n  .min(3)\n  .max(200)\n  .regex(/^[^/\\s]+\\/[^/\\s]+$/, 'Use the owner/name form, e.g. \"mastra-ai/mastra\".')\n  .describe('A repository linked to this Factory, as owner/name.');\n\nconst decisionId = z.string().trim().uuid().describe('Decision id, from factory_list_attention or inspect.');\n\nfunction briefItem(item: WorkItemRow) {\n  return {\n    id: item.id,\n    number: workItemNumber(item),\n    title: truncate(item.title, MAX_TEXT),\n    stage: workItemStage(item),\n  };\n}\n\nfunction settled(result: FactoryDecisionActionResult) {\n  if (!result.ok) throw new Error(result.message);\n  const { decision } = result;\n  return { decisionId: decision.id, status: decision.status, workItemId: decision.workItemId };\n}\n\n/** The work-item write and subscription tools for one user session's turn. */\nexport function createFactoryWorkItemTools(\n  scope: FactoryToolScope,\n  deps: FactoryWorkItemToolDependencies,\n): IntegrationTools {\n  const project = { orgId: scope.orgId, factoryProjectId: scope.factoryProjectId };\n  const audit: FactoryAuditEmit = async input => {\n    await deps.auditRecorder.record({\n      orgId: scope.orgId,\n      actorId: scope.userId,\n      actorType: 'human',\n      ...(scope.actorProfile ? { actorProfile: scope.actorProfile } : {}),\n      ...input,\n    });\n  };\n  const requireItem = async (ref: string) => {\n    const item = await findWorkItem(deps.workItems, scope, ref);\n    if (!item) throw workItemNotFound(ref);\n    return item;\n  };\n  /**\n   * Check `slug` is a repository linked to this Factory and that a card with\n   * `metadata` would run in it (a card synced from an issue follows the\n   * issue's repository, which a slug can't override).\n   */\n  const requireRepository = async (slug: string, metadata: Record<string, unknown> | null = null) => {\n    const sourceControl = await deps.sessions.getSourceControlBySessionId(scope.sessionId);\n    if (!sourceControl) throw new Error('This session has no source-control provider to look repositories up in.');\n    const resolve = (repository?: string) =>\n      resolveWorkItemRepository({\n        sourceControl,\n        ...project,\n        item: { metadata: repository ? { ...metadata, repository } : metadata },\n      });\n    const resolution = await resolve(slug);\n    if (resolution.status === 'resolved' && resolution.slug === slug) return;\n    if (resolution.status === 'resolved') {\n      throw new Error(`This card runs in ${resolution.slug}, which comes from its linked issue and can't be changed.`);\n    }\n    const linked = await resolve();\n    const candidates =\n      linked.status === 'ambiguous' ? linked.candidates : linked.status === 'resolved' ? [linked.slug] : [];\n    throw new Error(\n      candidates.length > 0\n        ? `${slug} is not linked to this Factory. Linked repositories: ${candidates.join(', ')}.`\n        : `${slug} is not linked to this Factory, and it has no linked repositories.`,\n    );\n  };\n  const follow = (item: WorkItemRow, reason: 'created' | 'subscribed') =>\n    deps.workItems.subscribeToWorkItem({\n      ...project,\n      workItemId: item.id,\n      sessionId: scope.sessionId,\n      threadId: scope.threadId,\n      resourceId: scope.resourceId,\n      userId: scope.userId,\n      reason,\n    });\n\n  return {\n    factory_create_work_item: createTool({\n      id: 'factory_create_work_item',\n      description:\n        \"File a new work item on this Factory's Work board for the person you are working with. It lands in the board's first phase, exactly like pressing New card, and this session follows it. Check factory_list_work_items for an existing item first. Name the repository when the Factory links more than one; runs refuse to start on a card that doesn't say which.\",\n      inputSchema: z\n        .object({\n          title: z.string().trim().min(1).max(512).describe('Short title, as it should read on the card.'),\n          brief: z\n            .string()\n            .trim()\n            .min(1)\n            .max(8000)\n            .describe('What needs doing and why; posted as the first comment on the card.'),\n          repository: repositorySchema.optional(),\n        })\n        .strict(),\n      execute: async ({ title, brief, repository }) => {\n        if (repository) await requireRepository(repository);\n        const created = await createFactoryWorkItem({\n          workItems: deps.workItems,\n          boards: deps.boards,\n          transitionService: deps.transitionService,\n          audit,\n          ...project,\n          userId: scope.userId,\n          ...(scope.actorProfile ? { origin: { actorProfile: scope.actorProfile } } : {}),\n          input: { title, ...(repository ? { metadata: { repository } } : {}) },\n        });\n        if (created.status === 'refused') throw new Error(created.message);\n        if (created.status === 'rejected') throw new Error(`The board refused the new item: ${created.reason}`);\n        const { item } = created;\n        // The card exists from here on: report follow-up failures alongside it\n        // rather than failing the call, so the agent doesn't file it twice.\n        const warnings: string[] = [];\n        try {\n          const comment = await deps.feed.createComment({\n            orgId: scope.orgId,\n            workItemId: item.id,\n            author: { kind: 'user', id: scope.userId },\n            body: brief,\n          });\n          if (comment.status !== 'created') {\n            warnings.push(\n              `The brief was not posted (${comment.status === 'invalid' ? comment.message : comment.status}).`,\n            );\n          }\n        } catch (error) {\n          warnings.push(`The brief was not posted: ${error instanceof Error ? error.message : String(error)}`);\n        }\n        try {\n          await follow(item, 'created');\n        } catch (error) {\n          warnings.push(\n            `This session does not follow it yet: ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n        return warnings.length ? { ...briefItem(item), warnings } : briefItem(item);\n      },\n    }),\n\n    factory_transition_work_item: createTool({\n      id: 'factory_transition_work_item',\n      description:\n        \"Move a work item to another stage of its board, as the person you are working with. The board's rules decide whether the move is allowed and what it starts.\",\n      inputSchema: z\n        .object({\n          workItem: workItemRefSchema,\n          stage: z.string().trim().min(1).max(64).describe('Destination stage, e.g. \"planning\" or \"done\".'),\n        })\n        .strict(),\n      execute: async ({ workItem, stage }) => {\n        if (!deps.transitionService) throw new Error('Factory stage transitions are not available right now.');\n        const item = await requireItem(workItem);\n        const parsed = transitionBodySchema.safeParse({\n          board: boardForWorkItem(item),\n          stage,\n          expectedRevision: item.revision,\n          requestId: randomUUID(),\n          cause: 'factory_tools',\n        });\n        if (!parsed.success) throw new Error(`\"${stage}\" is not a valid stage name.`);\n        const result = await deps.transitionService.transition({\n          ...parsed.data,\n          ...project,\n          workItemId: item.id,\n          actor: { type: 'human', id: scope.userId },\n          ...(scope.actorProfile ? { actorProfile: scope.actorProfile } : {}),\n          ingress: { ...parsed.data.ingress, identity: `human:${scope.userId}:${parsed.data.ingress.identity}` },\n        });\n        if (result.status === 'rejected') throw new Error(`The move was refused (${result.code}): ${result.reason}`);\n        return { workItemId: item.id, stage: result.stage, revision: result.revision };\n      },\n    }),\n\n    factory_update_work_item: createTool({\n      id: 'factory_update_work_item',\n      description:\n        \"Edit a work item's fields as the person you are working with: its title, the repository its runs use, its parent item, or pre-approving its plans. Move stages with factory_transition_work_item and start roles with factory_start_session; post to the card's feed for anything else.\",\n      inputSchema: z\n        .object({\n          workItem: workItemRefSchema,\n          title: z.string().trim().min(1).max(500).optional().describe('New card title.'),\n          repository: repositorySchema.optional(),\n          parentWorkItem: workItemRefSchema\n            .nullable()\n            .optional()\n            .describe('Parent work item (id or #number), or null to detach it from its parent.'),\n          plansPreapproved: z\n            .literal(true)\n            .optional()\n            .describe(\n              \"Pre-approve the item's plans, so its runs no longer stop for plan approval. Can't be undone here.\",\n            ),\n        })\n        .strict()\n        .refine(input => Object.keys(input).some(key => key !== 'workItem'), 'Pass at least one field to change.'),\n      execute: async ({ workItem, title, repository, parentWorkItem, plansPreapproved }) => {\n        const item = await requireItem(workItem);\n        if (repository) await requireRepository(repository, item.metadata);\n        let parentWorkItemId: string | null | undefined;\n        if (parentWorkItem === null) parentWorkItemId = null;\n        else if (parentWorkItem !== undefined) parentWorkItemId = (await requireItem(parentWorkItem)).id;\n        const patch: UpdateWorkItemInput = {\n          ...(title !== undefined ? { title } : {}),\n          ...(repository ? { metadata: { repository } } : {}),\n          ...(parentWorkItemId !== undefined ? { parentWorkItemId } : {}),\n          ...(plansPreapproved ? { plansPreapproved } : {}),\n        };\n        let updated: Awaited<ReturnType<WorkItemsStorage['update']>>;\n        try {\n          updated = await deps.workItems.update({ orgId: scope.orgId, id: item.id, userId: scope.userId, patch });\n        } catch (error) {\n          if (error instanceof WorkItemRelationError) throw new Error(`The parent was refused: ${error.message}`);\n          throw error;\n        }\n        if (!updated) throw workItemNotFound(workItem);\n        const fields = [\n          ...(title !== undefined ? ['title'] : []),\n          ...(repository ? ['metadata'] : []),\n          ...(parentWorkItemId !== undefined ? ['parentWorkItemId'] : []),\n          ...(plansPreapproved ? ['plansPreapproved'] : []),\n        ];\n        await audit({\n          action: 'factory.work_item.updated',\n          factoryProjectId: scope.factoryProjectId,\n          targets: [{ type: 'work_item', id: updated.item.id, name: updated.item.title }],\n          metadata: { fields, cause: 'factory_tools' },\n        });\n        const metadata = updated.item.metadata ?? {};\n        return {\n          workItem: briefItem(updated.item),\n          updated: fields.map(field => (field === 'metadata' ? 'repository' : field)),\n          repository: typeof metadata.repository === 'string' ? metadata.repository : null,\n          parentWorkItemId: updated.item.parentWorkItemId,\n          plansPreapproved: updated.item.plansPreapprovedAt !== null,\n        };\n      },\n    }),\n\n    factory_retry_decision: createTool({\n      id: 'factory_retry_decision',\n      description:\n        'Retry one failed Factory run once its cause is fixed. Refused when the failure cannot be fixed by retrying or the item has moved on.',\n      inputSchema: z.object({ decisionId }).strict(),\n      execute: async ({ decisionId }) =>\n        settled(await retryFactoryDecision({ workItems: deps.workItems, boards: deps.boards, ...project, decisionId })),\n    }),\n\n    factory_dismiss_decision: createTool({\n      id: 'factory_dismiss_decision',\n      description: 'Dismiss one proposed Factory run that is no longer wanted.',\n      inputSchema: z.object({ decisionId }).strict(),\n      execute: async ({ decisionId }) =>\n        settled(\n          await dismissFactoryDecision({\n            workItems: deps.workItems,\n            audit,\n            ...project,\n            userId: scope.userId,\n            decisionId,\n          }),\n        ),\n    }),\n\n    factory_resolve_proposal: createTool({\n      id: 'factory_resolve_proposal',\n      description:\n        \"Approve or dismiss one proposed Factory run. Approving starts the run and lets the item's later runs start without asking.\",\n      inputSchema: z.object({ decisionId, action: z.enum(['approve', 'dismiss']) }).strict(),\n      execute: async ({ decisionId, action }) =>\n        settled(\n          await resolveFactoryProposal({\n            workItems: deps.workItems,\n            audit,\n            ...project,\n            userId: scope.userId,\n            decisionId,\n            action,\n          }),\n        ),\n    }),\n\n    factory_subscribe_work_item: createTool({\n      id: 'factory_subscribe_work_item',\n      description:\n        'Follow a work item from this session, so you hear about its progress and its sessions report to you. Items you file or start are followed already.',\n      inputSchema: z.object({ workItem: workItemRefSchema }).strict(),\n      execute: async ({ workItem }) => {\n        const item = await requireItem(workItem);\n        const subscription = await follow(item, 'subscribed');\n        return { workItem: briefItem(item), subscribed: true, reason: subscription.reason };\n      },\n    }),\n\n    factory_unsubscribe_work_item: createTool({\n      id: 'factory_unsubscribe_work_item',\n      description: 'Stop following a work item from this session.',\n      inputSchema: z.object({ workItem: workItemRefSchema }).strict(),\n      execute: async ({ workItem }) => {\n        const item = await requireItem(workItem);\n        const removed = await deps.workItems.unsubscribeFromWorkItem({\n          orgId: scope.orgId,\n          workItemId: item.id,\n          sessionId: scope.sessionId,\n        });\n        return { workItem: briefItem(item), subscribed: false, wasSubscribed: removed };\n      },\n    }),\n  };\n}\n"],"mappings":"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"}