@mastra/factory 0.23.0 → 0.24.0-alpha.0

package/dist/supervisor/session.js

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

package/dist/supervisor/session.js.map

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

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

@@ -1,30 +0,0 @@
-import type { BoardRegistry } from '../boards/index.js';
-import type { IntegrationTools } from '../integrations/base.js';
-import type { FactoryTransitionService } from '../rules/transition-service.js';
-import type { AuditRecorder } from '../storage/domains/audit/domain.js';
-import type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';
-import type { SupervisorScope } from './read-tools.js';
-import type { WorkerMessageResult } from './session-messaging.js';
-interface SupervisorWriteDependencies {
-    scope: SupervisorScope;
-    userId: string;
-    workItems: WorkItemsStorage;
-    boards: BoardRegistry;
-    audit: AuditRecorder;
-    transitionService: FactoryTransitionService;
-    reconcileAcceptanceLabels?: (input: {
-        orgId: string;
-        factoryProjectId: string;
-        item: WorkItemRow;
-    }) => Promise<void>;
-    messageSession?: (input: {
-        sessionId: string;
-        message: string;
-        userId: string;
-        delivery: 'send' | 'queue';
-    }) => Promise<WorkerMessageResult>;
-    now?: () => Date;
-}
-export declare function createFactorySupervisorWriteTools(deps: SupervisorWriteDependencies): IntegrationTools;
-export {};
-//# sourceMappingURL=write-tools.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"write-tools.d.ts","sourceRoot":"","sources":["../../src/supervisor/write-tools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAG/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,UAAU,2BAA2B;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,yBAAyB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;KAC5B,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,2BAA2B,GAAG,gBAAgB,CA6NrG"}

package/dist/supervisor/write-tools.js

@@ -1,231 +0,0 @@
-import { BOARD_IDENTIFIER_RE } from "../rules/validation.js";
-import { boardForWorkItem } from "../boards/semantics.js";
-import "../boards/index.js";
-import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
-import { overtakenDecisionIds } from "../rules/decision-applicability.js";
-import { z } from "zod";
-import { createTool } from "@mastra/core/tools";
-//#region src/supervisor/write-tools.ts
-function createFactorySupervisorWriteTools(deps) {
-	const now = deps.now ?? (() => /* @__PURE__ */ new Date());
-	const audit = async (action, target, metadata = {}) => deps.audit.record({
-		orgId: deps.scope.orgId,
-		actorId: deps.userId,
-		actorType: "human",
-		action,
-		targets: [target],
-		factoryProjectId: deps.scope.factoryProjectId,
-		metadata: {
-			...metadata,
-			cause: "supervisor"
-		},
-		occurredAt: now()
-	});
-	return {
-		factory_retry_decision: createTool({
-			id: "factory_retry_decision",
-			description: "Retry one failed Factory decision after the person confirms the repair.",
-			inputSchema: z.object({ decisionId: z.string().min(1) }),
-			requireApproval: true,
-			execute: async ({ decisionId }) => {
-				const current = await deps.workItems.getDeferredDecision(deps.scope.orgId, deps.scope.factoryProjectId, decisionId);
-				if (!current || current.status !== "failed") throw new Error("The decision is not failed, no longer exists, or belongs to another factory.");
-				const failure = factoryDispatchFailureMetadata(current.failureCode);
-				if (!failure.canRetry) throw new Error(`This failure (${failure.label}) cannot be fixed by a retry; repair the cause and start a new run instead.`);
-				if ((await overtakenDecisionIds(deps.workItems, deps.boards, deps.scope, [current])).size > 0) throw new Error("The work item has moved on from the phase this run was decided for; it cannot be retried.");
-				const decision = await deps.workItems.retryDeferredDecision(deps.scope.orgId, deps.scope.factoryProjectId, decisionId, now());
-				if (!decision) throw new Error("The decision is not failed, no longer exists, or belongs to another factory.");
-				await audit("factory.run.retry", {
-					type: "rule_decision",
-					id: decisionId
-				}, { workItemId: decision.workItemId });
-				return {
-					decisionId,
-					status: decision.status,
-					workItemId: decision.workItemId
-				};
-			}
-		}),
-		factory_dismiss_decision: createTool({
-			id: "factory_dismiss_decision",
-			description: "Dismiss one parked Factory proposal after the person confirms it is no longer wanted.",
-			inputSchema: z.object({ decisionId: z.string().min(1) }),
-			requireApproval: true,
-			execute: async ({ decisionId }) => {
-				const decision = await deps.workItems.dismissDeferredDecision(deps.scope.orgId, deps.scope.factoryProjectId, decisionId, now());
-				if (!decision) throw new Error("The decision is not proposed, no longer exists, or belongs to another factory.");
-				await audit("factory.run.dismissed", {
-					type: "rule_decision",
-					id: decisionId
-				}, { workItemId: decision.workItemId });
-				return {
-					decisionId,
-					status: decision.status,
-					workItemId: decision.workItemId
-				};
-			}
-		}),
-		factory_resolve_proposal: createTool({
-			id: "factory_resolve_proposal",
-			description: "Approve or dismiss one proposed Factory decision after the person confirms the choice.",
-			inputSchema: z.object({
-				decisionId: z.string().min(1),
-				resolution: z.enum(["approve", "dismiss"])
-			}),
-			requireApproval: true,
-			execute: async ({ decisionId, resolution }) => {
-				const decision = resolution === "approve" ? await deps.workItems.approveDeferredDecision(deps.scope.orgId, deps.scope.factoryProjectId, decisionId, now(), deps.userId) : await deps.workItems.dismissDeferredDecision(deps.scope.orgId, deps.scope.factoryProjectId, decisionId, now());
-				if (!decision) throw new Error("The proposal is no longer open or belongs to another factory.");
-				await audit(resolution === "approve" ? "factory.run.approved" : "factory.run.dismissed", {
-					type: "rule_decision",
-					id: decisionId
-				}, { workItemId: decision.workItemId });
-				return {
-					decisionId,
-					resolution,
-					status: decision.status,
-					workItemId: decision.workItemId
-				};
-			}
-		}),
-		factory_transition_work_item: createTool({
-			id: "factory_transition_work_item",
-			description: "Move or accept one Factory work item after the person confirms the destination stage.",
-			inputSchema: z.object({
-				workItemId: z.string().min(1),
-				stage: z.string().max(128).regex(BOARD_IDENTIFIER_RE)
-			}),
-			requireApproval: true,
-			execute: async ({ workItemId, stage }) => {
-				const item = await deps.workItems.get({
-					orgId: deps.scope.orgId,
-					id: workItemId
-				});
-				if (!item || item.factoryProjectId !== deps.scope.factoryProjectId) throw new Error("Work item not found.");
-				if (!(item.stages.length === 1 ? item.stages[0] : void 0)) throw new Error("The work item does not have one valid Factory stage.");
-				const result = await deps.transitionService.transition({
-					orgId: deps.scope.orgId,
-					factoryProjectId: deps.scope.factoryProjectId,
-					workItemId,
-					board: boardForWorkItem(item),
-					stage,
-					expectedRevision: item.revision,
-					actor: {
-						type: "human",
-						id: deps.userId
-					},
-					ingress: {
-						type: "human",
-						identity: `supervisor:${deps.userId}:${workItemId}:${item.revision}:${stage}`
-					},
-					cause: "supervisor"
-				});
-				if (result.status !== "accepted") throw new Error(`The transition was rejected (${result.code}): ${result.reason}`);
-				return result;
-			}
-		}),
-		factory_reconcile_labels: createTool({
-			id: "factory_reconcile_labels",
-			description: "Reconcile stale acceptance labels for one accepted work item after the person confirms the repair.",
-			inputSchema: z.object({ workItemId: z.string().min(1) }),
-			requireApproval: true,
-			execute: async ({ workItemId }) => {
-				if (!deps.reconcileAcceptanceLabels) throw new Error("Acceptance-label reconciliation is unavailable.");
-				const item = await deps.workItems.get({
-					orgId: deps.scope.orgId,
-					id: workItemId
-				});
-				if (!item || item.factoryProjectId !== deps.scope.factoryProjectId) throw new Error("Work item not found.");
-				if (!item.acceptedAt) throw new Error("The work item has not been accepted.");
-				await deps.reconcileAcceptanceLabels({
-					...deps.scope,
-					item
-				});
-				await audit("factory.work_item.labels_reconciled", {
-					type: "work_item",
-					id: workItemId
-				});
-				return {
-					workItemId,
-					reconciled: true
-				};
-			}
-		}),
-		factory_revoke_binding: createTool({
-			id: "factory_revoke_binding",
-			description: "Revoke an orphaned or stale run binding after a health finding and person confirmation.",
-			inputSchema: z.object({ bindingId: z.string().min(1) }),
-			requireApproval: true,
-			execute: async ({ bindingId }) => {
-				const binding = await deps.workItems.revokeRunBinding({
-					orgId: deps.scope.orgId,
-					factoryProjectId: deps.scope.factoryProjectId,
-					bindingId,
-					revokedAt: now()
-				});
-				if (!binding) throw new Error("The binding is not active, no longer exists, or belongs to another factory.");
-				await audit("factory.intake.binding_updated", {
-					type: "run_binding",
-					id: bindingId
-				}, {
-					workItemId: binding.workItemId,
-					role: binding.role,
-					status: "revoked"
-				});
-				return {
-					bindingId,
-					status: binding.status,
-					workItemId: binding.workItemId,
-					role: binding.role
-				};
-			}
-		}),
-		factory_signal_session: createTool({
-			id: "factory_signal_session",
-			description: "Send bounded guidance to a worker session after the person confirms the exact message. Use queue only when the guidance should wait for the current run to finish.",
-			inputSchema: z.object({
-				sessionId: z.string().min(1),
-				message: z.string().trim().min(1).max(2e3),
-				delivery: z.enum(["send", "queue"]).default("send")
-			}),
-			requireApproval: true,
-			execute: async ({ sessionId, message, delivery }) => {
-				if (!deps.messageSession) throw new Error("Worker session messaging is unavailable.");
-				const binding = (await deps.workItems.listRunBindings(deps.scope.orgId, deps.scope.factoryProjectId)).find((row) => row.sessionId === sessionId);
-				if (!binding) throw new Error("The session does not belong to this factory.");
-				if ((await deps.messageSession({
-					sessionId,
-					message,
-					userId: deps.userId,
-					delivery
-				}))?.status === "interrupted") return {
-					sessionId,
-					delivered: false,
-					status: "interrupted",
-					delivery,
-					workItemId: binding.workItemId,
-					role: binding.role
-				};
-				await audit("factory.agent.signaled", {
-					type: "factory_session",
-					id: sessionId
-				}, {
-					workItemId: binding.workItemId,
-					role: binding.role,
-					delivery
-				});
-				return {
-					sessionId,
-					delivered: true,
-					delivery,
-					workItemId: binding.workItemId,
-					role: binding.role
-				};
-			}
-		})
-	};
-}
-//#endregion
-export { createFactorySupervisorWriteTools };
-
-//# sourceMappingURL=write-tools.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"write-tools.js","names":[],"sources":["../../src/supervisor/write-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 { overtakenDecisionIds } from '../rules/decision-applicability.js';\nimport { factoryDispatchFailureMetadata } from '../rules/dispatch-errors.js';\nimport type { FactoryTransitionService } from '../rules/transition-service.js';\nimport { BOARD_IDENTIFIER_RE, MAX_BOARD_IDENTIFIER_LENGTH } from '../rules/validation.js';\nimport type { AuditAction } from '../storage/domains/audit/actions.js';\nimport type { AuditRecorder } from '../storage/domains/audit/domain.js';\nimport type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport type { SupervisorScope } from './read-tools.js';\nimport type { WorkerMessageResult } from './session-messaging.js';\n\ninterface SupervisorWriteDependencies {\n  scope: SupervisorScope;\n  userId: string;\n  workItems: WorkItemsStorage;\n  boards: BoardRegistry;\n  audit: AuditRecorder;\n  transitionService: FactoryTransitionService;\n  reconcileAcceptanceLabels?: (input: { orgId: string; factoryProjectId: string; item: WorkItemRow }) => Promise<void>;\n  messageSession?: (input: {\n    sessionId: string;\n    message: string;\n    userId: string;\n    delivery: 'send' | 'queue';\n  }) => Promise<WorkerMessageResult>;\n  now?: () => Date;\n}\n\nexport function createFactorySupervisorWriteTools(deps: SupervisorWriteDependencies): IntegrationTools {\n  const now = deps.now ?? (() => new Date());\n  const audit = async (\n    action: AuditAction,\n    target: { type: string; id: string },\n    metadata: Record<string, unknown> = {},\n  ) =>\n    deps.audit.record({\n      orgId: deps.scope.orgId,\n      actorId: deps.userId,\n      actorType: 'human',\n      action,\n      targets: [target],\n      factoryProjectId: deps.scope.factoryProjectId,\n      metadata: { ...metadata, cause: 'supervisor' },\n      occurredAt: now(),\n    });\n\n  return {\n    factory_retry_decision: createTool({\n      id: 'factory_retry_decision',\n      description: 'Retry one failed Factory decision after the person confirms the repair.',\n      inputSchema: z.object({ decisionId: z.string().min(1) }),\n      requireApproval: true,\n      execute: async ({ decisionId }) => {\n        const current = await deps.workItems.getDeferredDecision(\n          deps.scope.orgId,\n          deps.scope.factoryProjectId,\n          decisionId,\n        );\n        if (!current || current.status !== 'failed') {\n          throw new Error('The decision is not failed, no longer exists, or belongs to another factory.');\n        }\n        const failure = factoryDispatchFailureMetadata(current.failureCode);\n        if (!failure.canRetry) {\n          throw new Error(\n            `This failure (${failure.label}) cannot be fixed by a retry; repair the cause and start a new run instead.`,\n          );\n        }\n        if ((await overtakenDecisionIds(deps.workItems, deps.boards, deps.scope, [current])).size > 0) {\n          throw new Error('The work item has moved on from the phase this run was decided for; it cannot be retried.');\n        }\n        const decision = await deps.workItems.retryDeferredDecision(\n          deps.scope.orgId,\n          deps.scope.factoryProjectId,\n          decisionId,\n          now(),\n        );\n        if (!decision) throw new Error('The decision is not failed, no longer exists, or belongs to another factory.');\n        await audit(\n          'factory.run.retry',\n          { type: 'rule_decision', id: decisionId },\n          { workItemId: decision.workItemId },\n        );\n        return { decisionId, status: decision.status, workItemId: decision.workItemId };\n      },\n    }),\n    factory_dismiss_decision: createTool({\n      id: 'factory_dismiss_decision',\n      description: 'Dismiss one parked Factory proposal after the person confirms it is no longer wanted.',\n      inputSchema: z.object({ decisionId: z.string().min(1) }),\n      requireApproval: true,\n      execute: async ({ decisionId }) => {\n        const decision = await deps.workItems.dismissDeferredDecision(\n          deps.scope.orgId,\n          deps.scope.factoryProjectId,\n          decisionId,\n          now(),\n        );\n        if (!decision)\n          throw new Error('The decision is not proposed, no longer exists, or belongs to another factory.');\n        await audit(\n          'factory.run.dismissed',\n          { type: 'rule_decision', id: decisionId },\n          { workItemId: decision.workItemId },\n        );\n        return { decisionId, status: decision.status, workItemId: decision.workItemId };\n      },\n    }),\n    factory_resolve_proposal: createTool({\n      id: 'factory_resolve_proposal',\n      description: 'Approve or dismiss one proposed Factory decision after the person confirms the choice.',\n      inputSchema: z.object({ decisionId: z.string().min(1), resolution: z.enum(['approve', 'dismiss']) }),\n      requireApproval: true,\n      execute: async ({ decisionId, resolution }) => {\n        const decision =\n          resolution === 'approve'\n            ? await deps.workItems.approveDeferredDecision(\n                deps.scope.orgId,\n                deps.scope.factoryProjectId,\n                decisionId,\n                now(),\n                deps.userId,\n              )\n            : await deps.workItems.dismissDeferredDecision(\n                deps.scope.orgId,\n                deps.scope.factoryProjectId,\n                decisionId,\n                now(),\n              );\n        if (!decision) throw new Error('The proposal is no longer open or belongs to another factory.');\n        await audit(\n          resolution === 'approve' ? 'factory.run.approved' : 'factory.run.dismissed',\n          {\n            type: 'rule_decision',\n            id: decisionId,\n          },\n          { workItemId: decision.workItemId },\n        );\n        return { decisionId, resolution, status: decision.status, workItemId: decision.workItemId };\n      },\n    }),\n    factory_transition_work_item: createTool({\n      id: 'factory_transition_work_item',\n      description: 'Move or accept one Factory work item after the person confirms the destination stage.',\n      inputSchema: z.object({\n        workItemId: z.string().min(1),\n        stage: z.string().max(MAX_BOARD_IDENTIFIER_LENGTH).regex(BOARD_IDENTIFIER_RE),\n      }),\n      requireApproval: true,\n      execute: async ({ workItemId, stage }) => {\n        const item = await deps.workItems.get({ orgId: deps.scope.orgId, id: workItemId });\n        if (!item || item.factoryProjectId !== deps.scope.factoryProjectId) throw new Error('Work item not found.');\n        const from = item.stages.length === 1 ? item.stages[0] : undefined;\n        if (!from) throw new Error('The work item does not have one valid Factory stage.');\n        const result = await deps.transitionService.transition({\n          orgId: deps.scope.orgId,\n          factoryProjectId: deps.scope.factoryProjectId,\n          workItemId,\n          board: boardForWorkItem(item),\n          stage,\n          expectedRevision: item.revision,\n          actor: { type: 'human', id: deps.userId },\n          ingress: { type: 'human', identity: `supervisor:${deps.userId}:${workItemId}:${item.revision}:${stage}` },\n          cause: 'supervisor',\n        });\n        if (result.status !== 'accepted') {\n          throw new Error(`The transition was rejected (${result.code}): ${result.reason}`);\n        }\n        return result;\n      },\n    }),\n    factory_reconcile_labels: createTool({\n      id: 'factory_reconcile_labels',\n      description: 'Reconcile stale acceptance labels for one accepted work item after the person confirms the repair.',\n      inputSchema: z.object({ workItemId: z.string().min(1) }),\n      requireApproval: true,\n      execute: async ({ workItemId }) => {\n        if (!deps.reconcileAcceptanceLabels) throw new Error('Acceptance-label reconciliation is unavailable.');\n        const item = await deps.workItems.get({ orgId: deps.scope.orgId, id: workItemId });\n        if (!item || item.factoryProjectId !== deps.scope.factoryProjectId) throw new Error('Work item not found.');\n        if (!item.acceptedAt) throw new Error('The work item has not been accepted.');\n        await deps.reconcileAcceptanceLabels({ ...deps.scope, item });\n        await audit('factory.work_item.labels_reconciled', { type: 'work_item', id: workItemId });\n        return { workItemId, reconciled: true };\n      },\n    }),\n    factory_revoke_binding: createTool({\n      id: 'factory_revoke_binding',\n      description: 'Revoke an orphaned or stale run binding after a health finding and person confirmation.',\n      inputSchema: z.object({ bindingId: z.string().min(1) }),\n      requireApproval: true,\n      execute: async ({ bindingId }) => {\n        const binding = await deps.workItems.revokeRunBinding({\n          orgId: deps.scope.orgId,\n          factoryProjectId: deps.scope.factoryProjectId,\n          bindingId,\n          revokedAt: now(),\n        });\n        if (!binding) throw new Error('The binding is not active, no longer exists, or belongs to another factory.');\n        await audit(\n          'factory.intake.binding_updated',\n          { type: 'run_binding', id: bindingId },\n          {\n            workItemId: binding.workItemId,\n            role: binding.role,\n            status: 'revoked',\n          },\n        );\n        return { bindingId, status: binding.status, workItemId: binding.workItemId, role: binding.role };\n      },\n    }),\n    factory_signal_session: createTool({\n      id: 'factory_signal_session',\n      description:\n        'Send bounded guidance to a worker session after the person confirms the exact message. Use queue only when the guidance should wait for the current run to finish.',\n      inputSchema: z.object({\n        sessionId: z.string().min(1),\n        message: z.string().trim().min(1).max(2000),\n        delivery: z.enum(['send', 'queue']).default('send'),\n      }),\n      requireApproval: true,\n      execute: async ({ sessionId, message, delivery }) => {\n        if (!deps.messageSession) throw new Error('Worker session messaging is unavailable.');\n        const bindings = await deps.workItems.listRunBindings(deps.scope.orgId, deps.scope.factoryProjectId);\n        const binding = bindings.find(row => row.sessionId === sessionId);\n        if (!binding) throw new Error('The session does not belong to this factory.');\n        const result = await deps.messageSession({ sessionId, message, userId: deps.userId, delivery });\n        if (result?.status === 'interrupted') {\n          return {\n            sessionId,\n            delivered: false,\n            status: 'interrupted',\n            delivery,\n            workItemId: binding.workItemId,\n            role: binding.role,\n          };\n        }\n        await audit(\n          'factory.agent.signaled',\n          { type: 'factory_session', id: sessionId },\n          {\n            workItemId: binding.workItemId,\n            role: binding.role,\n            delivery,\n          },\n        );\n        return { sessionId, delivered: true, delivery, workItemId: binding.workItemId, role: binding.role };\n      },\n    }),\n  };\n}\n"],"mappings":"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"}