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

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

@@ -1,5 +1,6 @@
 import { boardForWorkItem } from "../boards/semantics.js";
 import "../boards/index.js";
+import { toBoardSource } from "../boards/project-boards.js";
 import { WorkItemRelationError } from "../storage/domains/work-items/base.js";
 import { requirePerson } from "./scope.js";
 import { factoryWorkItemUrl } from "../links.js";
@@ -106,7 +107,7 @@ function createFactoryWorkItemTools(scope, deps) {
 				if (repository) await requireRepository(repository);
 				const created = await createFactoryWorkItem({
 					workItems: deps.workItems,
-					boards: deps.boards,
+					boards: await toBoardSource(deps.boards).load(project),
 					transitionService: deps.transitionService,
 					audit,
 					...project,
@@ -269,7 +270,7 @@ function createFactoryWorkItemTools(scope, deps) {
 			inputSchema: z.object({ decisionId }).strict(),
 			execute: async ({ decisionId }) => settled(await retryFactoryDecision({
 				workItems: deps.workItems,
-				boards: deps.boards,
+				boards: await toBoardSource(deps.boards).load(project),
 				...project,
 				decisionId
 			}))

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

@@ -1 +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 { factoryWorkItemUrl } from '../links.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 { requirePerson } from './scope.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    url:\n      factoryWorkItemUrl({\n        factoryProjectId: item.factoryProjectId,\n        board: boardForWorkItem(item),\n        workItemId: item.id,\n      }) ?? null,\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      // Turns nobody signed in started are recorded as this session's agent, as their moves are.\n      actorId: scope.interactive ? scope.userId : `agent:session:${scope.sessionId}`,\n      actorType: scope.interactive ? 'human' : 'agent',\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          ...(scope.interactive\n            ? {\n                actor: { type: 'human' as const, id: scope.userId },\n                ...(scope.actorProfile ? { actorProfile: scope.actorProfile } : {}),\n                ingress: { ...parsed.data.ingress, identity: `human:${scope.userId}:${parsed.data.ingress.identity}` },\n              }\n            : {\n                // Nobody signed in started this turn: move as this session's agent, so the\n                // plan gate and the agent's done gates apply and the move arms no runs.\n                actor: { type: 'agent' as const, bindingId: `session:${scope.sessionId}`, role: 'session' },\n                ingress: {\n                  type: 'agent' as const,\n                  identity: `session:${scope.sessionId}:${parsed.data.ingress.identity}`,\n                },\n              }),\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        // Pre-approval drops the plan-approval gate for good, so it is the person's call.\n        if (plansPreapproved) requirePerson(scope, 'pre-approve plans');\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        requirePerson(scope, 'dismiss a proposed run');\n        return settled(\n          await dismissFactoryDecision({\n            workItems: deps.workItems,\n            audit,\n            ...project,\n            userId: scope.userId,\n            decisionId,\n          }),\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        requirePerson(scope, 'approve or dismiss a proposed run');\n        return 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\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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"}
+{"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 { toBoardSource } from '../boards/project-boards.js';\nimport type { ProjectBoardSource } from '../boards/project-boards.js';\nimport type { IntegrationTools } from '../integrations/base.js';\nimport { factoryWorkItemUrl } from '../links.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 { requirePerson } from './scope.js';\nimport type { FactoryToolScope } from './scope.js';\n\nexport interface FactoryWorkItemToolDependencies {\n  workItems: WorkItemsStorage;\n  /** A fixed registry, or the per-project boards. */\n  boards: BoardRegistry | ProjectBoardSource;\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    url:\n      factoryWorkItemUrl({\n        factoryProjectId: item.factoryProjectId,\n        board: boardForWorkItem(item),\n        workItemId: item.id,\n      }) ?? null,\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      // Turns nobody signed in started are recorded as this session's agent, as their moves are.\n      actorId: scope.interactive ? scope.userId : `agent:session:${scope.sessionId}`,\n      actorType: scope.interactive ? 'human' : 'agent',\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: await toBoardSource(deps.boards).load(project),\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          ...(scope.interactive\n            ? {\n                actor: { type: 'human' as const, id: scope.userId },\n                ...(scope.actorProfile ? { actorProfile: scope.actorProfile } : {}),\n                ingress: { ...parsed.data.ingress, identity: `human:${scope.userId}:${parsed.data.ingress.identity}` },\n              }\n            : {\n                // Nobody signed in started this turn: move as this session's agent, so the\n                // plan gate and the agent's done gates apply and the move arms no runs.\n                actor: { type: 'agent' as const, bindingId: `session:${scope.sessionId}`, role: 'session' },\n                ingress: {\n                  type: 'agent' as const,\n                  identity: `session:${scope.sessionId}:${parsed.data.ingress.identity}`,\n                },\n              }),\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        // Pre-approval drops the plan-approval gate for good, so it is the person's call.\n        if (plansPreapproved) requirePerson(scope, 'pre-approve plans');\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(\n          await retryFactoryDecision({\n            workItems: deps.workItems,\n            boards: await toBoardSource(deps.boards).load(project),\n            ...project,\n            decisionId,\n          }),\n        ),\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        requirePerson(scope, 'dismiss a proposed run');\n        return settled(\n          await dismissFactoryDecision({\n            workItems: deps.workItems,\n            audit,\n            ...project,\n            userId: scope.userId,\n            decisionId,\n          }),\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        requirePerson(scope, 'approve or dismiss a proposed run');\n        return 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\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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"}

package/dist/workspace.d.ts

@@ -109,6 +109,8 @@ export interface SessionEnvironmentRepo {
 }
 /** The session's factory environment, resolved from the project and its `inEnvironment` links. */
 export interface SessionEnvironment {
+    /** The factory's display name. */
+    factoryName: string;
     repos: SessionEnvironmentRepo[];
     workspaceSetupCommand: string | undefined;
     /** Only an absolute root is passed on; the templates reject anything else. */

package/dist/workspace.d.ts.map

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

package/dist/workspace.js

@@ -13,10 +13,10 @@ import { LocalSkillSource, Workspace } from "@mastra/core/workspace";
 import { DEFAULT_CONFIG_DIR } from "@mastra/code-sdk/constants";
 import { existsSync } from "fs";
 import path, { dirname, join } from "path";
+import { InlineSkillSource } from "@mastra/core/skills";
 import { fileURLToPath } from "url";
 import { SandboxFilesystem } from "@mastra/code-sdk/agents/sandbox-filesystem";
 import { MASTRACODE_WORKSPACE_TOOLS } from "@mastra/code-sdk/agents/tool-availability";
-import { InlineSkillSource } from "@mastra/core/skills";
 // src/workspace.ts
 const WORKSPACE_ID_PREFIX = "mfw";
 const bundleDirectory = dirname(fileURLToPath(import.meta.url));
@@ -372,6 +372,7 @@ async function resolveProjectEnvironment(storage, project) {
 	}
 	const workdir = project.sandboxWorkingDirectory?.trim();
 	return {
+		factoryName: project.name,
 		repos,
 		workspaceSetupCommand: project.workspaceSetupCommand?.trim() || void 0,
 		workingDirectory: workdir?.startsWith("/") ? workdir : void 0,
@@ -540,6 +541,8 @@ function createWorkspaceFactory(options = {}) {
 		const constructSessionEntry = () => getSessionSandbox(session.id, repoFullName, () => {
 			const sandbox = instrumentMethods(factorySandbox.create({
 				sessionId: session.id,
+				...session.factoryProjectId ? { factoryId: session.factoryProjectId } : {},
+				...resolvedEnvironment ? { factoryName: resolvedEnvironment.factoryName } : {},
 				sandboxId: session.sandboxId ?? void 0,
 				repoFullName,
 				...environment ? environmentSandboxContext(environment, {
@@ -559,10 +562,16 @@ function createWorkspaceFactory(options = {}) {
 				"reconnect"
 			]);
 			sandbox.setOnStart((previous) => async (args) => {
-				await timedPhase(`workspace.onStart(${args.outcome})`, async () => {
-					await setupHook(args);
-				});
-				await previous?.(args);
+				try {
+					await timedPhase(`workspace.onStart(${args.outcome})`, async () => {
+						await setupHook(args);
+					});
+					await previous?.(args);
+				} catch (error) {
+					const physicalId = args.sandbox.sandboxId;
+					if (physicalId && error instanceof Error) error.message += ` (provider sandbox ${physicalId})`;
+					throw error;
+				}
 			});
 			startEagerly = eagerSandboxStart;
 			return sandbox;