@mastra/factory 0.29.0-alpha.7 → 0.29.0-alpha.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +50 -20
- package/dist/boards/board-events.d.ts +23 -0
- package/dist/boards/board-events.d.ts.map +1 -1
- package/dist/boards/board-events.js +37 -3
- package/dist/boards/board-events.js.map +1 -1
- package/dist/boards/board-writes.d.ts +6 -4
- package/dist/boards/board-writes.d.ts.map +1 -1
- package/dist/boards/board-writes.js +9 -6
- package/dist/boards/board-writes.js.map +1 -1
- package/dist/boards/intake-routing.d.ts +30 -16
- package/dist/boards/intake-routing.d.ts.map +1 -1
- package/dist/boards/intake-routing.js +41 -28
- package/dist/boards/intake-routing.js.map +1 -1
- package/dist/boards/project-boards.d.ts +15 -0
- package/dist/boards/project-boards.d.ts.map +1 -1
- package/dist/boards/project-boards.js +43 -7
- package/dist/boards/project-boards.js.map +1 -1
- package/dist/factory.d.ts +4 -14
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +22 -15
- package/dist/factory.js.map +1 -1
- package/dist/integrations/github/integration.d.ts.map +1 -1
- package/dist/integrations/github/integration.js +101 -0
- package/dist/integrations/github/integration.js.map +1 -1
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +7 -3
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/github/sandbox.d.ts +7 -1
- package/dist/integrations/github/sandbox.d.ts.map +1 -1
- package/dist/integrations/github/sandbox.js +15 -1
- package/dist/integrations/github/sandbox.js.map +1 -1
- package/dist/integrations/github/session-subscriptions.js +1 -1
- package/dist/integrations/github/session-subscriptions.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +2 -1
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/gitlab/session-subscriptions.js +1 -1
- package/dist/integrations/gitlab/session-subscriptions.js.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.d.ts +1 -0
- package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.js +4 -1
- package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
- package/dist/integrations/slack/run-error-card.js +6 -1
- package/dist/integrations/slack/run-error-card.js.map +1 -1
- package/dist/links.d.ts +4 -2
- package/dist/links.d.ts.map +1 -1
- package/dist/links.js +5 -3
- package/dist/links.js.map +1 -1
- package/dist/routes/boards.d.ts +1 -1
- package/dist/routes/boards.d.ts.map +1 -1
- package/dist/routes/boards.js.map +1 -1
- package/dist/routes/contracts.d.ts +32 -5
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +36 -9
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/intake-check.d.ts.map +1 -1
- package/dist/routes/intake-check.js +3 -1
- package/dist/routes/intake-check.js.map +1 -1
- package/dist/routes/intake-routes.d.ts +0 -3
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +1 -1
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/skills.d.ts +1 -1
- package/dist/routes/skills.d.ts.map +1 -1
- package/dist/routes/skills.js +92 -28
- package/dist/routes/skills.js.map +1 -1
- package/dist/routes/surface.d.ts +0 -3
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +0 -1
- package/dist/routes/surface.js.map +1 -1
- package/dist/rules/dispatch-errors.d.ts +6 -0
- package/dist/rules/dispatch-errors.d.ts.map +1 -1
- package/dist/rules/dispatch-errors.js +10 -1
- package/dist/rules/dispatch-errors.js.map +1 -1
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +74 -32
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/event-rules.d.ts +3 -2
- package/dist/rules/event-rules.d.ts.map +1 -1
- package/dist/rules/event-rules.js +5 -3
- package/dist/rules/event-rules.js.map +1 -1
- package/dist/rules/public-failure-reason.d.ts +11 -0
- package/dist/rules/public-failure-reason.d.ts.map +1 -0
- package/dist/rules/public-failure-reason.js +136 -0
- package/dist/rules/public-failure-reason.js.map +1 -0
- package/dist/rules/transition-service.d.ts +13 -0
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +5 -1
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +12 -0
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +11 -2
- package/dist/rules/validation.js.map +1 -1
- package/dist/run-error.d.ts +1 -1
- package/dist/run-error.d.ts.map +1 -1
- package/dist/run-error.js +21 -12
- package/dist/run-error.js.map +1 -1
- package/dist/session/environment-state-processor.d.ts.map +1 -1
- package/dist/session/environment-state-processor.js +6 -2
- package/dist/session/environment-state-processor.js.map +1 -1
- package/dist/session/source-control-tools.d.ts.map +1 -1
- package/dist/session/source-control-tools.js +5 -3
- package/dist/session/source-control-tools.js.map +1 -1
- package/dist/skills/app-skills.d.ts +3 -2
- package/dist/skills/app-skills.d.ts.map +1 -1
- package/dist/skills/app-skills.js +5 -3
- package/dist/skills/app-skills.js.map +1 -1
- package/dist/skills/catalog.d.ts +23 -4
- package/dist/skills/catalog.d.ts.map +1 -1
- package/dist/skills/catalog.js +61 -28
- package/dist/skills/catalog.js.map +1 -1
- package/dist/storage/domains/audit/actions.d.ts +1 -1
- package/dist/storage/domains/audit/actions.d.ts.map +1 -1
- package/dist/storage/domains/audit/actions.js +6 -1
- package/dist/storage/domains/audit/actions.js.map +1 -1
- package/dist/storage/domains/boards/base.d.ts +12 -0
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +3 -0
- package/dist/storage/domains/boards/base.js.map +1 -1
- package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
- package/dist/storage/domains/boards/schemas.js +4 -0
- package/dist/storage/domains/boards/schemas.js.map +1 -1
- package/dist/storage/domains/skill-overrides/base.d.ts +28 -4
- package/dist/storage/domains/skill-overrides/base.d.ts.map +1 -1
- package/dist/storage/domains/skill-overrides/base.js +54 -1
- package/dist/storage/domains/skill-overrides/base.js.map +1 -1
- package/dist/storage/domains/work-items/base.d.ts +2 -0
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +13 -5
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/tools/audit-events-tool.d.ts +1 -1
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +0 -1
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/work-item-tools.d.ts.map +1 -1
- package/dist/tools/work-item-tools.js +0 -3
- package/dist/tools/work-item-tools.js.map +1 -1
- package/dist/work-items/create-work-item.d.ts.map +1 -1
- package/dist/work-items/create-work-item.js +2 -1
- package/dist/work-items/create-work-item.js.map +1 -1
- package/dist/workspace.d.ts +5 -1
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +69 -9
- package/dist/workspace.js.map +1 -1
- package/package.json +7 -7
|
@@ -19,7 +19,7 @@ export declare function createAuditEventsTool(scope: FactoryToolScope, deps: Fac
|
|
|
19
19
|
actor?: string | undefined;
|
|
20
20
|
includeAgentRuns?: boolean | undefined;
|
|
21
21
|
namespace?: "agent" | "board" | "git" | "intake" | "intake_order" | "intake_route" | "run" | "sandbox_env" | "session" | "skill" | "work_item" | undefined;
|
|
22
|
-
actions?: ("factory.agent.commit" | "factory.agent.pr_opened" | "factory.agent.push" | "factory.agent.signaled" | "factory.board.created" | "factory.board.deleted" | "factory.board.reset" | "factory.board.updated" | "factory.git.commit" | "factory.git.pr_opened" | "factory.git.push" | "factory.intake.binding_updated" | "factory.intake.config_updated" | "factory.intake.label_route_updated" | "factory.intake.routed_again" | "factory.intake_order.evaluator_updated" | "factory.intake_order.updated" | "factory.intake_route.created" | "factory.intake_route.deleted" | "factory.intake_route.reordered" | "factory.intake_route.rerouted" | "factory.intake_route.updated" | "factory.run.approved" | "factory.run.dismissed" | "factory.run.ended" | "factory.run.queued" | "factory.run.rejected" | "factory.run.retry" | "factory.run.started" | "factory.sandbox_env.deleted" | "factory.sandbox_env.set" | "factory.sandbox_env.updated" | "factory.session.owner_transferred" | "factory.skill.reverted" | "factory.skill.updated" | "factory.work_item.created" | "factory.work_item.deleted" | "factory.work_item.labels_reconciled" | "factory.work_item.stage_moved" | "factory.work_item.transition_rejected" | "factory.work_item.updated")[] | undefined;
|
|
22
|
+
actions?: ("factory.agent.commit" | "factory.agent.pr_opened" | "factory.agent.push" | "factory.agent.signaled" | "factory.board.created" | "factory.board.deleted" | "factory.board.reset" | "factory.board.updated" | "factory.git.commit" | "factory.git.pr_opened" | "factory.git.push" | "factory.intake.binding_updated" | "factory.intake.config_updated" | "factory.intake.label_route_updated" | "factory.intake.routed_again" | "factory.intake_order.evaluator_updated" | "factory.intake_order.updated" | "factory.intake_route.created" | "factory.intake_route.deleted" | "factory.intake_route.reordered" | "factory.intake_route.rerouted" | "factory.intake_route.updated" | "factory.run.approved" | "factory.run.dismissed" | "factory.run.ended" | "factory.run.queued" | "factory.run.rejected" | "factory.run.retry" | "factory.run.started" | "factory.sandbox_env.deleted" | "factory.sandbox_env.set" | "factory.sandbox_env.updated" | "factory.session.owner_transferred" | "factory.skill.created" | "factory.skill.deleted" | "factory.skill.reverted" | "factory.skill.updated" | "factory.work_item.created" | "factory.work_item.deleted" | "factory.work_item.labels_reconciled" | "factory.work_item.stage_moved" | "factory.work_item.transition_rejected" | "factory.work_item.updated")[] | undefined;
|
|
23
23
|
workItem?: string | undefined;
|
|
24
24
|
since?: string | undefined;
|
|
25
25
|
until?: string | undefined;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../src/tools/read-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,oBAAoB,CAAC;AAExE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAGV,IAAI,EACJ,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,QAAQ,KAAK,CAAC;AAG3B,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,IAAI,CACb,gBAAgB,EACd,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,uBAAuB,GACvB,WAAW,GACX,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,CAC7B,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClC,mDAAmD;IACnD,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC3C,mHAAmH;IACnH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;IACvE,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG,SAAS,CAAC;CAC5E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAQD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAU3B,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,eAAe,CAAC,EACjE,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,kBAAkB,CAAC,EAC3D,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAsBtB;AAoCD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAEnD;
|
|
1
|
+
{"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../src/tools/read-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,oBAAoB,CAAC;AAExE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAGV,IAAI,EACJ,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,QAAQ,KAAK,CAAC;AAG3B,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,IAAI,CACb,gBAAgB,EACd,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,uBAAuB,GACvB,WAAW,GACX,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,CAC7B,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClC,mDAAmD;IACnD,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC3C,mHAAmH;IACnH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;IACvE,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG,SAAS,CAAC;CAC5E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAQD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAU3B,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,eAAe,CAAC,EACjE,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,kBAAkB,CAAC,EAC3D,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAsBtB;AAoCD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAEnD;AAiGD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,2BAA2B,GAAG,gBAAgB,CAuOnH"}
|
package/dist/tools/read-tools.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"read-tools.js","names":[],"sources":["../../src/tools/read-tools.ts"],"sourcesContent":["import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport {\n awaitsAcceptance,\n boardFlow,\n boardForWorkItem,\n pullRequestSourceNumber,\n pullRequestSources,\n} from '../boards/index.js';\nimport type { BoardRegistry, InstalledBoard } 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 { factorySessionUrl, factoryWorkItemUrl } from '../links.js';\nimport { parkedRunLabel } from '../routes/attention-parked.js';\nimport { decisionRetryable, overtakenDecisionIds } from '../rules/decision-applicability.js';\nimport { factoryDispatchFailureMetadata } from '../rules/dispatch-errors.js';\nimport { needsApproval } from '../rules/types.js';\nimport type { LiveSessions } from '../session/live-sessions.js';\nimport type { AuditStorage } from '../storage/domains/audit/base.js';\nimport type {\n FactoryDeferredDecisionRecord,\n FactoryRunBindingRecord,\n Card,\n WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\nimport { workItemNumber } from '../work-items/card-number.js';\nimport { cardCarries, isCardFor, isSourceReference, sourceKeyFromReference } from '../work-items/card-reference.js';\nimport { sessionActivity } from './deliver.js';\nimport type { FactorySessionActivity } from './deliver.js';\nimport type { FactoryMessaging } from './messaging-tools.js';\nimport type { FactoryToolScope } from './scope.js';\n\nexport const MAX_TEXT = 600;\nexport const MAX_ERROR = 400;\nexport const MAX_LIST = 50;\nconst DEFAULT_LIST = 25;\n\nexport interface FactoryReadToolDependencies {\n workItems: Pick<\n WorkItemsStorage,\n | 'listShared'\n | 'getForProject'\n | 'listRunBindings'\n | 'listDeferredDecisions'\n | 'listByIds'\n | 'listDecisionsForEvaluations'\n | 'listWorkItemSubscribers'\n | 'listSessionSubscriptions'\n >;\n audit: Pick<AuditStorage, 'list'>;\n /** A fixed registry, or the per-project boards. */\n boards: BoardRegistry | ProjectBoardSource;\n /** The live controller, for whether a session is mid-run and when it last moved; absent before the mount is up. */\n messaging?: () => Promise<Pick<FactoryMessaging, 'controller'> | null>;\n /** Which live sessions are parked on a tool prompt; absent before the mount is up. */\n liveSessions?: () => Pick<LiveSessions, 'parked' | 'parkedIn'> | undefined;\n}\n\nexport function truncate(text: string, max: number): string {\n return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\nfunction iso(value: Date | string | null | undefined): string | null {\n if (!value) return null;\n const date = value instanceof Date ? value : new Date(value);\n return Number.isFinite(date.getTime()) ? date.toISOString() : null;\n}\n\nexport function workItemStage(item: Pick<Card, 'stages'>): string {\n return item.stages.join('+');\n}\n\n/**\n * A work item id, its card number, or the issue or pull request it tracks, as people paste it: a\n * link, `owner/repo#123`, `group/project!7` or a tracker key like `ENG-42`. Anything else can't\n * name an item.\n */\nexport const workItemRefSchema = z\n .string()\n .trim()\n .max(512)\n .refine(ref => z.string().uuid().safeParse(ref).success || /^#?\\d+$/.test(ref) || isSourceReference(ref), {\n message:\n 'Use a work item id (UUID), its number like \"#123\", or the link or owner/repo#123 of the issue or pull request it tracks.',\n })\n .describe(\n 'Work item id, its number like \"#123\", or the issue or pull request it tracks: its link, owner/repo#123, or a key like ENG-42. With several repositories, prefer the link: a bare number can belong to more than one.',\n );\n\n/**\n * Resolve a ref validated by `workItemRefSchema` to an item in this Factory only. A link or\n * shorthand finds the card of that issue or pull request, else the card it is attached to.\n */\nexport async function findWorkItem(\n workItems: Pick<WorkItemsStorage, 'listShared' | 'getForProject'>,\n scope: Pick<FactoryToolScope, 'orgId' | 'factoryProjectId'>,\n ref: string,\n): Promise<Card | null> {\n const trimmed = ref.trim();\n if (z.string().uuid().safeParse(trimmed).success) {\n return workItems.getForProject(scope.orgId, scope.factoryProjectId, trimmed);\n }\n const number = /^#?(\\d+)$/.exec(trimmed)?.[1];\n if (number === undefined) return findBySource(await workItems.listShared(scope), trimmed);\n const items = await workItems.listShared(scope);\n const matches = items.filter(item => workItemNumber(item) === Number(number));\n // Issue and PR numbers share a space on GitHub; prefer the issue's card.\n const workCards = matches.filter(item => item.externalSource?.type !== 'pull-request');\n // Hand-filed card numbers and issue numbers from several repositories can repeat; refuse to guess.\n refuseAmbiguous(number, workCards);\n const match = workCards[0] ?? matches[0];\n if (match) return structuredClone(match);\n // A pull request attached to an issue's card is found through that card. Pull request numbers\n // repeat across repositories too.\n const carriers = items.filter(item =>\n pullRequestSources(item).some(source => pullRequestSourceNumber(source) === Number(number)),\n );\n refuseAmbiguous(number, carriers);\n return carriers[0] ? structuredClone(carriers[0]) : null;\n}\n\nfunction findBySource(items: readonly Card[], ref: string): Card | null {\n // The issue's or pull request's own card first, then a card it is attached to (a pull request on its issue's card).\n for (const tier of [items.filter(item => isCardFor(item, ref)), items.filter(item => cardCarries(item, ref))]) {\n refuseAmbiguous(ref, tier);\n if (tier[0]) return structuredClone(tier[0]);\n }\n return null;\n}\n\nfunction refuseAmbiguous(ref: string, items: readonly Card[]): void {\n if (items.length <= 1) return;\n const candidates = items\n .map(item => `${item.id} (${item.title}, ${boardForWorkItem(item)} › ${workItemStage(item)})`)\n .join(', ');\n const label = /^\\d+$/.test(ref) ? `#${ref}` : ref;\n throw new Error(`${label} matches more than one work item; use its id instead: ${candidates}.`);\n}\n\n/** The stage the card is in and where its board lets it go next, as the board shows its move buttons. */\nfunction boardMoves(board: InstalledBoard | undefined, item: Card) {\n const stage = item.stages.length === 1 ? item.stages[0]! : undefined;\n const phase = board && stage !== undefined && Object.hasOwn(board.phases, stage) ? board.phases[stage] : undefined;\n if (!board || !phase || stage === undefined) return null;\n return {\n board: { key: board.id, name: board.name },\n stage: { key: stage, name: phase.name, kind: phase.kind },\n // A working stage runs its skill again when the card is moved to the stage it is in.\n canRerun: phase.kind === 'working',\n next: phase.nextPhases\n .filter(key => Object.hasOwn(board.phases, key))\n .map(key => ({ key, name: board.phases[key]!.name, kind: board.phases[key]!.kind })),\n };\n}\n\nexport function workItemNotFound(ref: string): Error {\n return new Error(`No work item ${ref} was found in this Factory.`);\n}\n\nfunction activeWorker(bindings: FactoryRunBindingRecord[], itemId: string) {\n const binding = bindings.find(candidate => candidate.workItemId === itemId && candidate.status === 'active');\n return binding ? { role: binding.role, sessionId: binding.sessionId } : null;\n}\n\n/** The card on its Factory board; null when the server has no public URL configured. */\nfunction workItemUrl(item: Card) {\n return (\n factoryWorkItemUrl({\n factoryProjectId: item.factoryProjectId,\n board: boardForWorkItem(item),\n workItemId: item.id,\n }) ?? null\n );\n}\n\nfunction summarizeItem(item: Card, bindings: FactoryRunBindingRecord[]) {\n return {\n id: item.id,\n number: workItemNumber(item),\n title: truncate(item.title, MAX_TEXT),\n board: boardForWorkItem(item),\n stage: workItemStage(item),\n url: workItemUrl(item),\n activeWorker: activeWorker(bindings, item.id),\n requestedBy: item.createdBy,\n updatedAt: iso(item.updatedAt),\n };\n}\n\nfunction summarizeDecision(decision: FactoryDeferredDecisionRecord, overtaken = false) {\n const type = typeof decision.decision.type === 'string' ? decision.decision.type : 'decision';\n const role = typeof decision.decision.role === 'string' ? decision.decision.role : null;\n return {\n id: decision.id,\n workItemId: decision.workItemId,\n type,\n role,\n status: decision.status,\n attempts: decision.attempts,\n failureCode: decision.failureCode,\n failureLabel: decision.failureCode ? factoryDispatchFailureMetadata(decision.failureCode).label : null,\n canRetry: decisionRetryable(decision, overtaken),\n error: decision.lastError ? truncate(decision.lastError, MAX_ERROR) : null,\n approvedBy: decision.approvedBy,\n updatedAt: iso(decision.updatedAt),\n };\n}\n\n/**\n * Held: a card triage left resting (or whose source asks for approval), until a person moves it\n * on. A card that has been past triage since (parked by self-review, or dragged back) resumes\n * instead, matching the board's held state.\n */\nfunction isHeld(boards: BoardRegistry, item: Card): boolean {\n const board = boards.get(boardForWorkItem(item));\n const stage = item.stages.length === 1 ? item.stages[0]! : undefined;\n if (!board || !stage || board.phaseKind(stage) !== 'resting') return false;\n if (needsApproval(item, phase => awaitsAcceptance(board, phase))) return true;\n const triage = boardFlow(board).triage;\n const triageRole = triage ? board.roleForPhase(triage) : undefined;\n if (!triageRole || item.sessions[triageRole] === undefined) return false;\n return !item.stageHistory.some(entry => entry.stage !== triage && board.isWorking(entry.stage));\n}\n\nconst listInputSchema = z\n .object({\n query: z\n .string()\n .trim()\n .min(1)\n .max(200)\n .optional()\n .describe(\n 'Case-insensitive text in the title, an exact card number like \"#123\", or the link, owner/repo#123 or key (ENG-42) of an issue or pull request, which finds the cards tracking it.',\n ),\n stage: z\n .string()\n .min(1)\n .max(64)\n .optional()\n .describe(\n 'Only items in this stage, by its key as items list it (e.g. \"intake\" or \"planning\"); a board\\'s review stage key can differ from its name.',\n ),\n board: z.string().min(1).max(64).optional().describe('Only items on this board, by its key, e.g. \"work\".'),\n role: z.string().min(1).max(64).optional().describe('Only items that have a session for this role.'),\n active: z.boolean().optional().describe('true: only items with an agent working now; false: only idle items.'),\n requestedBy: z.literal('me').optional().describe('\"me\": only items you filed.'),\n subscribed: z\n .boolean()\n .optional()\n .describe('true: only items this session follows; false: only items it does not.'),\n limit: z.number().int().min(1).max(MAX_LIST).optional().describe(`Default ${DEFAULT_LIST}, max ${MAX_LIST}.`),\n })\n .strict();\n\nexport function createFactoryReadTools(scope: FactoryToolScope, deps: FactoryReadToolDependencies): IntegrationTools {\n const project = { orgId: scope.orgId, factoryProjectId: scope.factoryProjectId };\n return {\n factory_list_work_items: createTool({\n id: 'factory_list_work_items',\n description:\n \"List this Factory's work items, newest activity first, with counts per stage for the whole Factory. Filter by text or #number, stage, board, role, whether an agent is working on it, items you filed, or items this session follows. Check here for an existing item before filing a new one.\",\n inputSchema: listInputSchema,\n execute: async input => {\n const [items, bindings, followed] = await Promise.all([\n deps.workItems.listShared(project),\n deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId),\n input.subscribed === undefined\n ? undefined\n : deps.workItems.listSessionSubscriptions({ ...project, sessionId: scope.sessionId }),\n ]);\n const followedIds = new Set(followed?.map(subscription => subscription.workItemId));\n const byStage: Record<string, number> = {};\n for (const item of items) {\n const stage = workItemStage(item);\n byStage[stage] = (byStage[stage] ?? 0) + 1;\n }\n const numberQuery = input.query ? /^#(\\d+)$/.exec(input.query)?.[1] : undefined;\n // A pasted link or owner/repo#123 finds the cards tracking that issue or pull request, not titles.\n const sourceQuery =\n input.query && numberQuery === undefined && sourceKeyFromReference(input.query) !== null\n ? input.query\n : undefined;\n const text = input.query?.toLowerCase();\n const matches = items\n .filter(item => {\n if (numberQuery !== undefined) {\n if (workItemNumber(item) !== Number(numberQuery)) return false;\n } else if (sourceQuery !== undefined) {\n if (!cardCarries(item, sourceQuery)) return false;\n } else if (text && !item.title.toLowerCase().includes(text)) return false;\n if (input.stage && !item.stages.includes(input.stage)) return false;\n if (input.board && boardForWorkItem(item) !== input.board) return false;\n if (input.role && !item.sessions[input.role]) return false;\n if (input.active !== undefined && (activeWorker(bindings, item.id) !== null) !== input.active) return false;\n if (input.requestedBy === 'me' && item.createdBy !== scope.userId) return false;\n if (input.subscribed !== undefined && followedIds.has(item.id) !== input.subscribed) return false;\n return true;\n })\n .sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime());\n const limit = input.limit ?? DEFAULT_LIST;\n return {\n counts: { total: items.length, byStage },\n items: matches.slice(0, limit).map(item => summarizeItem(item, bindings)),\n truncated: matches.length > limit,\n };\n },\n }),\n\n factory_inspect_work_item: createTool({\n id: 'factory_inspect_work_item',\n description:\n 'Everything the Factory knows about one work item: its description, the stages its board lets it move to next, stage history, sessions by role (with whether each is mid-run and when its thread last moved), decisions with errors, recent audit events, labels, linked items and the sessions following it. Use it to explain why an item is where it is, and to pick the stage key factory_transition_work_item takes.',\n inputSchema: z.object({ workItem: workItemRefSchema }).strict(),\n execute: async ({ workItem }) => {\n const item = await findWorkItem(deps.workItems, scope, workItem);\n if (!item) throw workItemNotFound(workItem);\n const [bindings, decisions, audit, all, subscribers] = await Promise.all([\n deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id),\n deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, { workItemId: item.id }),\n deps.audit.list({ ...project, limit: 200 }),\n deps.workItems.listShared(project),\n deps.workItems.listWorkItemSubscribers({ orgId: scope.orgId, workItemId: item.id }),\n ]);\n const itemDecisions = decisions.slice(-MAX_LIST);\n const boards = await toBoardSource(deps.boards).load(project);\n const overtaken = await overtakenDecisionIds(\n deps.workItems,\n boards,\n project,\n itemDecisions.filter(decision => decision.status === 'failed'),\n );\n const labels = Array.isArray(item.workItem.labels)\n ? item.workItem.labels.filter((label): label is string => typeof label === 'string').slice(0, MAX_LIST)\n : [];\n const parent = item.parentWorkItemId\n ? all.find(candidate => candidate.id === item.parentWorkItemId)\n : undefined;\n const children = all.filter(candidate => candidate.parentWorkItemId === item.id);\n const controller = (await deps.messaging?.())?.controller;\n const activity = async (sessionId: string, threadId: string): Promise<FactorySessionActivity | null> =>\n controller ? sessionActivity(controller, sessionId, threadId) : null;\n const sessions = await Promise.all(\n Object.entries(item.sessions).map(async ([role, ref]) => ({\n role,\n sessionId: ref.sessionId,\n threadId: ref.threadId,\n url:\n factorySessionUrl({\n factoryProjectId: item.factoryProjectId,\n sessionId: ref.sessionId,\n threadId: ref.threadId,\n }) ?? null,\n startedBy: ref.startedBy,\n active: bindings.some(\n binding => binding.role === role && binding.sessionId === ref.sessionId && binding.status === 'active',\n ),\n // `running` with an old `lastActivityAt` is a stuck run; `running` with a recent one is a long one.\n ...((await activity(ref.sessionId, ref.threadId)) ?? { running: null, lastActivityAt: null }),\n })),\n );\n return {\n item: {\n ...summarizeItem(item, bindings),\n description: item.description,\n source: item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : 'manual',\n sourceUrl: typeof item.workItem.url === 'string' ? item.workItem.url : null,\n revision: item.revision,\n },\n moves: boardMoves(boards.get(boardForWorkItem(item)), item),\n labels,\n stageHistory: item.stageHistory.slice(-MAX_LIST).map(entry => ({\n stage: entry.stage,\n enteredAt: entry.enteredAt,\n exitedAt: entry.exitedAt ?? null,\n by: entry.by,\n })),\n sessions,\n decisions: itemDecisions.map(decision => summarizeDecision(decision, overtaken.has(decision.id))),\n audit: audit.events\n .filter(event => event.targets.some(target => target.type === 'work_item' && target.id === item.id))\n .slice(0, 25)\n .map(event => ({\n action: event.action,\n actorId: event.actorId,\n actorType: event.actorType,\n occurredAt: iso(event.occurredAt),\n })),\n parent: parent ? summarizeItem(parent, bindings) : null,\n children: children.slice(0, MAX_LIST).map(child => summarizeItem(child, bindings)),\n subscribers: subscribers.slice(0, MAX_LIST).map(subscription => ({\n sessionId: subscription.sessionId,\n reason: subscription.reason,\n isCaller: subscription.sessionId === scope.sessionId,\n })),\n };\n },\n }),\n\n factory_list_attention: createTool({\n id: 'factory_list_attention',\n description:\n 'What in this Factory needs a person: failed decisions grouped by failure code and error (one incident per group), proposals waiting for approval, runs parked on a tool prompt (a plan to review, a question to answer) while still in flight, and Work cards triage left in Intake for a person to move on.',\n inputSchema: z.object({ limit: z.number().int().min(1).max(MAX_LIST).optional() }).strict(),\n execute: async ({ limit = DEFAULT_LIST }) => {\n const [decisions, items] = await Promise.all([\n deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, {\n statuses: ['failed', 'proposed'],\n }),\n deps.workItems.listShared(project),\n ]);\n const itemsById = new Map(items.map(item => [item.id, item]));\n const failed = decisions.filter(decision => decision.status === 'failed');\n const groups = new Map<\n string,\n { failureCode: string; error: string; decisions: FactoryDeferredDecisionRecord[] }\n >();\n for (const decision of failed) {\n const error = truncate(decision.lastError ?? '', MAX_ERROR);\n const key = `${decision.failureCode ?? 'unknown'}|${error}`;\n const group = groups.get(key) ?? { failureCode: decision.failureCode ?? 'unknown', error, decisions: [] };\n group.decisions.push(decision);\n groups.set(key, group);\n }\n const ref = (workItemId: string | null) => {\n const item = workItemId ? itemsById.get(workItemId) : undefined;\n return {\n workItemId,\n number: item ? workItemNumber(item) : null,\n title: item ? truncate(item.title, MAX_TEXT) : null,\n url: item ? workItemUrl(item) : null,\n };\n };\n const allIncidents = [...groups.values()].sort((a, b) => b.decisions.length - a.decisions.length);\n const incidents = allIncidents\n .slice(0, limit)\n .map(group => ({ ...group, shown: group.decisions.slice(0, limit) }));\n // Check exactly the decisions this call returns, so every canRetry is real.\n const boards = await toBoardSource(deps.boards).load(project);\n const overtaken = await overtakenDecisionIds(\n deps.workItems,\n boards,\n project,\n incidents.flatMap(group => group.shown),\n );\n const proposals = decisions.filter(decision => decision.status === 'proposed');\n const held = items.filter(item => isHeld(boards, item));\n const waiting = (deps.liveSessions?.()?.parkedIn(scope.factoryProjectId) ?? []).sort(\n (a, b) => a.run.suspendedAt - b.run.suspendedAt,\n );\n return {\n incidents: incidents.map(group => ({\n failureCode: group.failureCode,\n failureLabel: factoryDispatchFailureMetadata(group.decisions[0]!.failureCode).label,\n error: group.error,\n count: group.decisions.length,\n decisions: group.shown.map(decision => ({\n id: decision.id,\n ...ref(decision.workItemId),\n attempts: decision.attempts,\n canRetry: decisionRetryable(decision, overtaken.has(decision.id)),\n })),\n })),\n proposals: proposals\n .slice(0, limit)\n .map(decision => ({ ...summarizeDecision(decision), ...ref(decision.workItemId) })),\n waiting: waiting.slice(0, limit).map(({ sessionId, run }) => ({\n sessionId,\n toolName: run.toolName,\n label: parkedRunLabel(run.toolName),\n waitingSince: new Date(run.suspendedAt).toISOString(),\n })),\n held: held.slice(0, limit).map(item => ({\n ...ref(item.id),\n stage: workItemStage(item),\n })),\n truncated:\n allIncidents.length > limit ||\n incidents.some(group => group.shown.length < group.decisions.length) ||\n proposals.length > limit ||\n waiting.length > limit ||\n held.length > limit,\n };\n },\n }),\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkCA,MAAa,WAAW;AACxB,MAAa,YAAY;AACzB,MAAa,WAAW;AACxB,MAAM,eAAe;AAuBrB,SAAgB,SAAS,MAAc,KAAqB;CAC1D,OAAO,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK;AAC5D;AAEA,SAAS,IAAI,OAAwD;CACnE,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,OAAO,iBAAiB,OAAO,QAAQ,IAAI,KAAK,KAAK;CAC3D,OAAO,OAAO,SAAS,KAAK,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI;AAChE;AAEA,SAAgB,cAAc,MAAoC;CAChE,OAAO,KAAK,OAAO,KAAK,GAAG;AAC7B;;;;;;AAOA,MAAa,oBAAoB,EAC9B,OAAO,CAAC,CACR,KAAK,CAAC,CACN,IAAI,GAAG,CAAC,CACR,QAAO,QAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,WAAW,UAAU,KAAK,GAAG,KAAK,kBAAkB,GAAG,GAAG,EACxG,SACE,6HACJ,CAAC,CAAC,CACD,SACC,wNACF;;;;;AAMF,eAAsB,aACpB,WACA,OACA,KACsB;CACtB,MAAM,UAAU,IAAI,KAAK;CACzB,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,OAAO,CAAC,CAAC,SACvC,OAAO,UAAU,cAAc,MAAM,OAAO,MAAM,kBAAkB,OAAO;CAE7E,MAAM,SAAS,YAAY,KAAK,OAAO,CAAC,GAAG;CAC3C,IAAI,WAAW,KAAA,GAAW,OAAO,aAAa,MAAM,UAAU,WAAW,KAAK,GAAG,OAAO;CACxF,MAAM,QAAQ,MAAM,UAAU,WAAW,KAAK;CAC9C,MAAM,UAAU,MAAM,QAAO,SAAQ,eAAe,IAAI,MAAM,OAAO,MAAM,CAAC;CAE5E,MAAM,YAAY,QAAQ,QAAO,SAAQ,KAAK,gBAAgB,SAAS,cAAc;CAErF,gBAAgB,QAAQ,SAAS;CACjC,MAAM,QAAQ,UAAU,MAAM,QAAQ;CACtC,IAAI,OAAO,OAAO,gBAAgB,KAAK;CAGvC,MAAM,WAAW,MAAM,QAAO,SAC5B,mBAAmB,IAAI,CAAC,CAAC,MAAK,WAAU,wBAAwB,MAAM,MAAM,OAAO,MAAM,CAAC,CAC5F;CACA,gBAAgB,QAAQ,QAAQ;CAChC,OAAO,SAAS,KAAK,gBAAgB,SAAS,EAAE,IAAI;AACtD;AAEA,SAAS,aAAa,OAAwB,KAA0B;CAEtE,KAAK,MAAM,QAAQ,CAAC,MAAM,QAAO,SAAQ,UAAU,MAAM,GAAG,CAAC,GAAG,MAAM,QAAO,SAAQ,YAAY,MAAM,GAAG,CAAC,CAAC,GAAG;EAC7G,gBAAgB,KAAK,IAAI;EACzB,IAAI,KAAK,IAAI,OAAO,gBAAgB,KAAK,EAAE;CAC7C;CACA,OAAO;AACT;AAEA,SAAS,gBAAgB,KAAa,OAA8B;CAClE,IAAI,MAAM,UAAU,GAAG;CACvB,MAAM,aAAa,MAChB,KAAI,SAAQ,GAAG,KAAK,GAAG,IAAI,KAAK,MAAM,IAAI,iBAAiB,IAAI,EAAE,KAAK,cAAc,IAAI,EAAE,EAAE,CAAC,CAC7F,KAAK,IAAI;CACZ,MAAM,QAAQ,QAAQ,KAAK,GAAG,IAAI,IAAI,QAAQ;CAC9C,MAAM,IAAI,MAAM,GAAG,MAAM,wDAAwD,WAAW,EAAE;AAChG;;AAGA,SAAS,WAAW,OAAmC,MAAY;CACjE,MAAM,QAAQ,KAAK,OAAO,WAAW,IAAI,KAAK,OAAO,KAAM,KAAA;CAC3D,MAAM,QAAQ,SAAS,UAAU,KAAA,KAAa,OAAO,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,OAAO,SAAS,KAAA;CACzG,IAAI,CAAC,SAAS,CAAC,SAAS,UAAU,KAAA,GAAW,OAAO;CACpD,OAAO;EACL,OAAO;GAAE,KAAK,MAAM;GAAI,MAAM,MAAM;EAAK;EACzC,OAAO;GAAE,KAAK;GAAO,MAAM,MAAM;GAAM,MAAM,MAAM;EAAK;EAExD,UAAU,MAAM,SAAS;EACzB,MAAM,MAAM,WACT,QAAO,QAAO,OAAO,OAAO,MAAM,QAAQ,GAAG,CAAC,CAAC,CAC/C,KAAI,SAAQ;GAAE;GAAK,MAAM,MAAM,OAAO,IAAI,CAAE;GAAM,MAAM,MAAM,OAAO,IAAI,CAAE;EAAK,EAAE;CACvF;AACF;AAEA,SAAgB,iBAAiB,KAAoB;CACnD,uBAAO,IAAI,MAAM,gBAAgB,IAAI,4BAA4B;AACnE;AAEA,SAAS,aAAa,UAAqC,QAAgB;CACzE,MAAM,UAAU,SAAS,MAAK,cAAa,UAAU,eAAe,UAAU,UAAU,WAAW,QAAQ;CAC3G,OAAO,UAAU;EAAE,MAAM,QAAQ;EAAM,WAAW,QAAQ;CAAU,IAAI;AAC1E;;AAGA,SAAS,YAAY,MAAY;CAC/B,OACE,mBAAmB;EACjB,kBAAkB,KAAK;EACvB,OAAO,iBAAiB,IAAI;EAC5B,YAAY,KAAK;CACnB,CAAC,KAAK;AAEV;AAEA,SAAS,cAAc,MAAY,UAAqC;CACtE,OAAO;EACL,IAAI,KAAK;EACT,QAAQ,eAAe,IAAI;EAC3B,OAAO,SAAS,KAAK,OAAA,GAAe;EACpC,OAAO,iBAAiB,IAAI;EAC5B,OAAO,cAAc,IAAI;EACzB,KAAK,YAAY,IAAI;EACrB,cAAc,aAAa,UAAU,KAAK,EAAE;EAC5C,aAAa,KAAK;EAClB,WAAW,IAAI,KAAK,SAAS;CAC/B;AACF;AAEA,SAAS,kBAAkB,UAAyC,YAAY,OAAO;CACrF,MAAM,OAAO,OAAO,SAAS,SAAS,SAAS,WAAW,SAAS,SAAS,OAAO;CACnF,MAAM,OAAO,OAAO,SAAS,SAAS,SAAS,WAAW,SAAS,SAAS,OAAO;CACnF,OAAO;EACL,IAAI,SAAS;EACb,YAAY,SAAS;EACrB;EACA;EACA,QAAQ,SAAS;EACjB,UAAU,SAAS;EACnB,aAAa,SAAS;EACtB,cAAc,SAAS,cAAc,+BAA+B,SAAS,WAAW,CAAC,CAAC,QAAQ;EAClG,UAAU,kBAAkB,UAAU,SAAS;EAC/C,OAAO,SAAS,YAAY,SAAS,SAAS,WAAA,GAAoB,IAAI;EACtE,YAAY,SAAS;EACrB,WAAW,IAAI,SAAS,SAAS;CACnC;AACF;;;;;;AAOA,SAAS,OAAO,QAAuB,MAAqB;CAC1D,MAAM,QAAQ,OAAO,IAAI,iBAAiB,IAAI,CAAC;CAC/C,MAAM,QAAQ,KAAK,OAAO,WAAW,IAAI,KAAK,OAAO,KAAM,KAAA;CAC3D,IAAI,CAAC,SAAS,CAAC,SAAS,MAAM,UAAU,KAAK,MAAM,WAAW,OAAO;CACrE,IAAI,cAAc,OAAM,UAAS,iBAAiB,OAAO,KAAK,CAAC,GAAG,OAAO;CACzE,MAAM,SAAS,UAAU,KAAK,CAAC,CAAC;CAChC,MAAM,aAAa,SAAS,MAAM,aAAa,MAAM,IAAI,KAAA;CACzD,IAAI,CAAC,cAAc,KAAK,SAAS,gBAAgB,KAAA,GAAW,OAAO;CACnE,OAAO,CAAC,KAAK,aAAa,MAAK,UAAS,MAAM,UAAU,UAAU,MAAM,UAAU,MAAM,KAAK,CAAC;AAChG;AAEA,MAAM,kBAAkB,EACrB,OAAO;CACN,OAAO,EACJ,OAAO,CAAC,CACR,KAAK,CAAC,CACN,IAAI,CAAC,CAAC,CACN,IAAI,GAAG,CAAC,CACR,SAAS,CAAC,CACV,SACC,qLACF;CACF,OAAO,EACJ,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,IAAI,EAAE,CAAC,CACP,SAAS,CAAC,CACV,SACC,+IACF;CACF,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,sDAAoD;CACzG,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,+CAA+C;CACnG,QAAQ,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,qEAAqE;CAC7G,aAAa,EAAE,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,+BAA6B;CAC9E,YAAY,EACT,QAAQ,CAAC,CACT,SAAS,CAAC,CACV,SAAS,uEAAuE;CACnF,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,EAAY,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,WAAW,aAAa,UAAmB;AAC9G,CAAC,CAAC,CACD,OAAO;AAEV,SAAgB,uBAAuB,OAAyB,MAAqD;CACnH,MAAM,UAAU;EAAE,OAAO,MAAM;EAAO,kBAAkB,MAAM;CAAiB;CAC/E,OAAO;EACL,yBAAyB,WAAW;GAClC,IAAI;GACJ,aACE;GACF,aAAa;GACb,SAAS,OAAM,UAAS;IACtB,MAAM,CAAC,OAAO,UAAU,YAAY,MAAM,QAAQ,IAAI;KACpD,KAAK,UAAU,WAAW,OAAO;KACjC,KAAK,UAAU,gBAAgB,MAAM,OAAO,MAAM,gBAAgB;KAClE,MAAM,eAAe,KAAA,IACjB,KAAA,IACA,KAAK,UAAU,yBAAyB;MAAE,GAAG;MAAS,WAAW,MAAM;KAAU,CAAC;IACxF,CAAC;IACD,MAAM,cAAc,IAAI,IAAI,UAAU,KAAI,iBAAgB,aAAa,UAAU,CAAC;IAClF,MAAM,UAAkC,CAAC;IACzC,KAAK,MAAM,QAAQ,OAAO;KACxB,MAAM,QAAQ,cAAc,IAAI;KAChC,QAAQ,UAAU,QAAQ,UAAU,KAAK;IAC3C;IACA,MAAM,cAAc,MAAM,QAAQ,WAAW,KAAK,MAAM,KAAK,CAAC,GAAG,KAAK,KAAA;IAEtE,MAAM,cACJ,MAAM,SAAS,gBAAgB,KAAA,KAAa,uBAAuB,MAAM,KAAK,MAAM,OAChF,MAAM,QACN,KAAA;IACN,MAAM,OAAO,MAAM,OAAO,YAAY;IACtC,MAAM,UAAU,MACb,QAAO,SAAQ;KACd,IAAI,gBAAgB,KAAA,GACd;UAAA,eAAe,IAAI,MAAM,OAAO,WAAW,GAAG,OAAO;KAAA,OACpD,IAAI,gBAAgB,KAAA,GACrB;UAAA,CAAC,YAAY,MAAM,WAAW,GAAG,OAAO;KAAA,OACvC,IAAI,QAAQ,CAAC,KAAK,MAAM,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;KACpE,IAAI,MAAM,SAAS,CAAC,KAAK,OAAO,SAAS,MAAM,KAAK,GAAG,OAAO;KAC9D,IAAI,MAAM,SAAS,iBAAiB,IAAI,MAAM,MAAM,OAAO,OAAO;KAClE,IAAI,MAAM,QAAQ,CAAC,KAAK,SAAS,MAAM,OAAO,OAAO;KACrD,IAAI,MAAM,WAAW,KAAA,KAAc,aAAa,UAAU,KAAK,EAAE,MAAM,SAAU,MAAM,QAAQ,OAAO;KACtG,IAAI,MAAM,gBAAgB,QAAQ,KAAK,cAAc,MAAM,QAAQ,OAAO;KAC1E,IAAI,MAAM,eAAe,KAAA,KAAa,YAAY,IAAI,KAAK,EAAE,MAAM,MAAM,YAAY,OAAO;KAC5F,OAAO;IACT,CAAC,CAAC,CACD,MAAM,MAAM,UAAU,MAAM,UAAU,QAAQ,IAAI,KAAK,UAAU,QAAQ,CAAC;IAC7E,MAAM,QAAQ,MAAM,SAAS;IAC7B,OAAO;KACL,QAAQ;MAAE,OAAO,MAAM;MAAQ;KAAQ;KACvC,OAAO,QAAQ,MAAM,GAAG,KAAK,CAAC,CAAC,KAAI,SAAQ,cAAc,MAAM,QAAQ,CAAC;KACxE,WAAW,QAAQ,SAAS;IAC9B;GACF;EACF,CAAC;EAED,2BAA2B,WAAW;GACpC,IAAI;GACJ,aACE;GACF,aAAa,EAAE,OAAO,EAAE,UAAU,kBAAkB,CAAC,CAAC,CAAC,OAAO;GAC9D,SAAS,OAAO,EAAE,eAAe;IAC/B,MAAM,OAAO,MAAM,aAAa,KAAK,WAAW,OAAO,QAAQ;IAC/D,IAAI,CAAC,MAAM,MAAM,iBAAiB,QAAQ;IAC1C,MAAM,CAAC,UAAU,WAAW,OAAO,KAAK,eAAe,MAAM,QAAQ,IAAI;KACvE,KAAK,UAAU,gBAAgB,MAAM,OAAO,MAAM,kBAAkB,KAAK,EAAE;KAC3E,KAAK,UAAU,sBAAsB,MAAM,OAAO,MAAM,kBAAkB,EAAE,YAAY,KAAK,GAAG,CAAC;KACjG,KAAK,MAAM,KAAK;MAAE,GAAG;MAAS,OAAO;KAAI,CAAC;KAC1C,KAAK,UAAU,WAAW,OAAO;KACjC,KAAK,UAAU,wBAAwB;MAAE,OAAO,MAAM;MAAO,YAAY,KAAK;KAAG,CAAC;IACpF,CAAC;IACD,MAAM,gBAAgB,UAAU,MAAM,GAAS;IAC/C,MAAM,SAAS,MAAM,cAAc,KAAK,MAAM,CAAC,CAAC,KAAK,OAAO;IAC5D,MAAM,YAAY,MAAM,qBACtB,KAAK,WACL,QACA,SACA,cAAc,QAAO,aAAY,SAAS,WAAW,QAAQ,CAC/D;IACA,MAAM,SAAS,MAAM,QAAQ,KAAK,SAAS,MAAM,IAC7C,KAAK,SAAS,OAAO,QAAQ,UAA2B,OAAO,UAAU,QAAQ,CAAC,CAAC,MAAM,GAAA,EAAW,IACpG,CAAC;IACL,MAAM,SAAS,KAAK,mBAChB,IAAI,MAAK,cAAa,UAAU,OAAO,KAAK,gBAAgB,IAC5D,KAAA;IACJ,MAAM,WAAW,IAAI,QAAO,cAAa,UAAU,qBAAqB,KAAK,EAAE;IAC/E,MAAM,cAAc,MAAM,KAAK,YAAY,EAAA,EAAI;IAC/C,MAAM,WAAW,OAAO,WAAmB,aACzC,aAAa,gBAAgB,YAAY,WAAW,QAAQ,IAAI;IAClE,MAAM,WAAW,MAAM,QAAQ,IAC7B,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,UAAU;KACxD;KACA,WAAW,IAAI;KACf,UAAU,IAAI;KACd,KACE,kBAAkB;MAChB,kBAAkB,KAAK;MACvB,WAAW,IAAI;MACf,UAAU,IAAI;KAChB,CAAC,KAAK;KACR,WAAW,IAAI;KACf,QAAQ,SAAS,MACf,YAAW,QAAQ,SAAS,QAAQ,QAAQ,cAAc,IAAI,aAAa,QAAQ,WAAW,QAChG;KAEA,GAAK,MAAM,SAAS,IAAI,WAAW,IAAI,QAAQ,KAAM;MAAE,SAAS;MAAM,gBAAgB;KAAK;IAC7F,EAAE,CACJ;IACA,OAAO;KACL,MAAM;MACJ,GAAG,cAAc,MAAM,QAAQ;MAC/B,aAAa,KAAK;MAClB,QAAQ,KAAK,iBAAiB,GAAG,KAAK,eAAe,cAAc,GAAG,KAAK,eAAe,SAAS;MACnG,WAAW,OAAO,KAAK,SAAS,QAAQ,WAAW,KAAK,SAAS,MAAM;MACvE,UAAU,KAAK;KACjB;KACA,OAAO,WAAW,OAAO,IAAI,iBAAiB,IAAI,CAAC,GAAG,IAAI;KAC1D;KACA,cAAc,KAAK,aAAa,MAAM,GAAS,CAAC,CAAC,KAAI,WAAU;MAC7D,OAAO,MAAM;MACb,WAAW,MAAM;MACjB,UAAU,MAAM,YAAY;MAC5B,IAAI,MAAM;KACZ,EAAE;KACF;KACA,WAAW,cAAc,KAAI,aAAY,kBAAkB,UAAU,UAAU,IAAI,SAAS,EAAE,CAAC,CAAC;KAChG,OAAO,MAAM,OACV,QAAO,UAAS,MAAM,QAAQ,MAAK,WAAU,OAAO,SAAS,eAAe,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CACnG,MAAM,GAAG,EAAE,CAAC,CACZ,KAAI,WAAU;MACb,QAAQ,MAAM;MACd,SAAS,MAAM;MACf,WAAW,MAAM;MACjB,YAAY,IAAI,MAAM,UAAU;KAClC,EAAE;KACJ,QAAQ,SAAS,cAAc,QAAQ,QAAQ,IAAI;KACnD,UAAU,SAAS,MAAM,GAAA,EAAW,CAAC,CAAC,KAAI,UAAS,cAAc,OAAO,QAAQ,CAAC;KACjF,aAAa,YAAY,MAAM,GAAA,EAAW,CAAC,CAAC,KAAI,kBAAiB;MAC/D,WAAW,aAAa;MACxB,QAAQ,aAAa;MACrB,UAAU,aAAa,cAAc,MAAM;KAC7C,EAAE;IACJ;GACF;EACF,CAAC;EAED,wBAAwB,WAAW;GACjC,IAAI;GACJ,aACE;GACF,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,EAAY,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO;GAC1F,SAAS,OAAO,EAAE,QAAQ,mBAAmB;IAC3C,MAAM,CAAC,WAAW,SAAS,MAAM,QAAQ,IAAI,CAC3C,KAAK,UAAU,sBAAsB,MAAM,OAAO,MAAM,kBAAkB,EACxE,UAAU,CAAC,UAAU,UAAU,EACjC,CAAC,GACD,KAAK,UAAU,WAAW,OAAO,CACnC,CAAC;IACD,MAAM,YAAY,IAAI,IAAI,MAAM,KAAI,SAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;IAC5D,MAAM,SAAS,UAAU,QAAO,aAAY,SAAS,WAAW,QAAQ;IACxE,MAAM,yBAAS,IAAI,IAGjB;IACF,KAAK,MAAM,YAAY,QAAQ;KAC7B,MAAM,QAAQ,SAAS,SAAS,aAAa,IAAA,GAAa;KAC1D,MAAM,MAAM,GAAG,SAAS,eAAe,UAAU,GAAG;KACpD,MAAM,QAAQ,OAAO,IAAI,GAAG,KAAK;MAAE,aAAa,SAAS,eAAe;MAAW;MAAO,WAAW,CAAC;KAAE;KACxG,MAAM,UAAU,KAAK,QAAQ;KAC7B,OAAO,IAAI,KAAK,KAAK;IACvB;IACA,MAAM,OAAO,eAA8B;KACzC,MAAM,OAAO,aAAa,UAAU,IAAI,UAAU,IAAI,KAAA;KACtD,OAAO;MACL;MACA,QAAQ,OAAO,eAAe,IAAI,IAAI;MACtC,OAAO,OAAO,SAAS,KAAK,OAAA,GAAe,IAAI;MAC/C,KAAK,OAAO,YAAY,IAAI,IAAI;KAClC;IACF;IACA,MAAM,eAAe,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,SAAS,EAAE,UAAU,MAAM;IAChG,MAAM,YAAY,aACf,MAAM,GAAG,KAAK,CAAC,CACf,KAAI,WAAU;KAAE,GAAG;KAAO,OAAO,MAAM,UAAU,MAAM,GAAG,KAAK;IAAE,EAAE;IAEtE,MAAM,SAAS,MAAM,cAAc,KAAK,MAAM,CAAC,CAAC,KAAK,OAAO;IAC5D,MAAM,YAAY,MAAM,qBACtB,KAAK,WACL,QACA,SACA,UAAU,SAAQ,UAAS,MAAM,KAAK,CACxC;IACA,MAAM,YAAY,UAAU,QAAO,aAAY,SAAS,WAAW,UAAU;IAC7E,MAAM,OAAO,MAAM,QAAO,SAAQ,OAAO,QAAQ,IAAI,CAAC;IACtD,MAAM,WAAW,KAAK,eAAe,CAAC,EAAE,SAAS,MAAM,gBAAgB,KAAK,CAAC,EAAA,CAAG,MAC7E,GAAG,MAAM,EAAE,IAAI,cAAc,EAAE,IAAI,WACtC;IACA,OAAO;KACL,WAAW,UAAU,KAAI,WAAU;MACjC,aAAa,MAAM;MACnB,cAAc,+BAA+B,MAAM,UAAU,EAAE,CAAE,WAAW,CAAC,CAAC;MAC9E,OAAO,MAAM;MACb,OAAO,MAAM,UAAU;MACvB,WAAW,MAAM,MAAM,KAAI,cAAa;OACtC,IAAI,SAAS;OACb,GAAG,IAAI,SAAS,UAAU;OAC1B,UAAU,SAAS;OACnB,UAAU,kBAAkB,UAAU,UAAU,IAAI,SAAS,EAAE,CAAC;MAClE,EAAE;KACJ,EAAE;KACF,WAAW,UACR,MAAM,GAAG,KAAK,CAAC,CACf,KAAI,cAAa;MAAE,GAAG,kBAAkB,QAAQ;MAAG,GAAG,IAAI,SAAS,UAAU;KAAE,EAAE;KACpF,SAAS,QAAQ,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK,EAAE,WAAW,WAAW;MAC5D;MACA,UAAU,IAAI;MACd,OAAO,eAAe,IAAI,QAAQ;MAClC,cAAc,IAAI,KAAK,IAAI,WAAW,CAAC,CAAC,YAAY;KACtD,EAAE;KACF,MAAM,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC,KAAI,UAAS;MACtC,GAAG,IAAI,KAAK,EAAE;MACd,OAAO,cAAc,IAAI;KAC3B,EAAE;KACF,WACE,aAAa,SAAS,SACtB,UAAU,MAAK,UAAS,MAAM,MAAM,SAAS,MAAM,UAAU,MAAM,KACnE,UAAU,SAAS,SACnB,QAAQ,SAAS,SACjB,KAAK,SAAS;IAClB;GACF;EACF,CAAC;CACH;AACF"}
|
|
1
|
+
{"version":3,"file":"read-tools.js","names":[],"sources":["../../src/tools/read-tools.ts"],"sourcesContent":["import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport {\n awaitsAcceptance,\n boardFlow,\n boardForWorkItem,\n pullRequestSourceNumber,\n pullRequestSources,\n} from '../boards/index.js';\nimport type { BoardRegistry, InstalledBoard } 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 { factorySessionUrl, factoryWorkItemUrl } from '../links.js';\nimport { parkedRunLabel } from '../routes/attention-parked.js';\nimport { decisionRetryable, overtakenDecisionIds } from '../rules/decision-applicability.js';\nimport { factoryDispatchFailureMetadata } from '../rules/dispatch-errors.js';\nimport { needsApproval } from '../rules/types.js';\nimport type { LiveSessions } from '../session/live-sessions.js';\nimport type { AuditStorage } from '../storage/domains/audit/base.js';\nimport type {\n FactoryDeferredDecisionRecord,\n FactoryRunBindingRecord,\n Card,\n WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\nimport { workItemNumber } from '../work-items/card-number.js';\nimport { cardCarries, isCardFor, isSourceReference, sourceKeyFromReference } from '../work-items/card-reference.js';\nimport { sessionActivity } from './deliver.js';\nimport type { FactorySessionActivity } from './deliver.js';\nimport type { FactoryMessaging } from './messaging-tools.js';\nimport type { FactoryToolScope } from './scope.js';\n\nexport const MAX_TEXT = 600;\nexport const MAX_ERROR = 400;\nexport const MAX_LIST = 50;\nconst DEFAULT_LIST = 25;\n\nexport interface FactoryReadToolDependencies {\n workItems: Pick<\n WorkItemsStorage,\n | 'listShared'\n | 'getForProject'\n | 'listRunBindings'\n | 'listDeferredDecisions'\n | 'listByIds'\n | 'listDecisionsForEvaluations'\n | 'listWorkItemSubscribers'\n | 'listSessionSubscriptions'\n >;\n audit: Pick<AuditStorage, 'list'>;\n /** A fixed registry, or the per-project boards. */\n boards: BoardRegistry | ProjectBoardSource;\n /** The live controller, for whether a session is mid-run and when it last moved; absent before the mount is up. */\n messaging?: () => Promise<Pick<FactoryMessaging, 'controller'> | null>;\n /** Which live sessions are parked on a tool prompt; absent before the mount is up. */\n liveSessions?: () => Pick<LiveSessions, 'parked' | 'parkedIn'> | undefined;\n}\n\nexport function truncate(text: string, max: number): string {\n return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\nfunction iso(value: Date | string | null | undefined): string | null {\n if (!value) return null;\n const date = value instanceof Date ? value : new Date(value);\n return Number.isFinite(date.getTime()) ? date.toISOString() : null;\n}\n\nexport function workItemStage(item: Pick<Card, 'stages'>): string {\n return item.stages.join('+');\n}\n\n/**\n * A work item id, its card number, or the issue or pull request it tracks, as people paste it: a\n * link, `owner/repo#123`, `group/project!7` or a tracker key like `ENG-42`. Anything else can't\n * name an item.\n */\nexport const workItemRefSchema = z\n .string()\n .trim()\n .max(512)\n .refine(ref => z.string().uuid().safeParse(ref).success || /^#?\\d+$/.test(ref) || isSourceReference(ref), {\n message:\n 'Use a work item id (UUID), its number like \"#123\", or the link or owner/repo#123 of the issue or pull request it tracks.',\n })\n .describe(\n 'Work item id, its number like \"#123\", or the issue or pull request it tracks: its link, owner/repo#123, or a key like ENG-42. With several repositories, prefer the link: a bare number can belong to more than one.',\n );\n\n/**\n * Resolve a ref validated by `workItemRefSchema` to an item in this Factory only. A link or\n * shorthand finds the card of that issue or pull request, else the card it is attached to.\n */\nexport async function findWorkItem(\n workItems: Pick<WorkItemsStorage, 'listShared' | 'getForProject'>,\n scope: Pick<FactoryToolScope, 'orgId' | 'factoryProjectId'>,\n ref: string,\n): Promise<Card | null> {\n const trimmed = ref.trim();\n if (z.string().uuid().safeParse(trimmed).success) {\n return workItems.getForProject(scope.orgId, scope.factoryProjectId, trimmed);\n }\n const number = /^#?(\\d+)$/.exec(trimmed)?.[1];\n if (number === undefined) return findBySource(await workItems.listShared(scope), trimmed);\n const items = await workItems.listShared(scope);\n const matches = items.filter(item => workItemNumber(item) === Number(number));\n // Issue and PR numbers share a space on GitHub; prefer the issue's card.\n const workCards = matches.filter(item => item.externalSource?.type !== 'pull-request');\n // Hand-filed card numbers and issue numbers from several repositories can repeat; refuse to guess.\n refuseAmbiguous(number, workCards);\n const match = workCards[0] ?? matches[0];\n if (match) return structuredClone(match);\n // A pull request attached to an issue's card is found through that card. Pull request numbers\n // repeat across repositories too.\n const carriers = items.filter(item =>\n pullRequestSources(item).some(source => pullRequestSourceNumber(source) === Number(number)),\n );\n refuseAmbiguous(number, carriers);\n return carriers[0] ? structuredClone(carriers[0]) : null;\n}\n\nfunction findBySource(items: readonly Card[], ref: string): Card | null {\n // The issue's or pull request's own card first, then a card it is attached to (a pull request on its issue's card).\n for (const tier of [items.filter(item => isCardFor(item, ref)), items.filter(item => cardCarries(item, ref))]) {\n refuseAmbiguous(ref, tier);\n if (tier[0]) return structuredClone(tier[0]);\n }\n return null;\n}\n\nfunction refuseAmbiguous(ref: string, items: readonly Card[]): void {\n if (items.length <= 1) return;\n const candidates = items\n .map(item => `${item.id} (${item.title}, ${boardForWorkItem(item)} › ${workItemStage(item)})`)\n .join(', ');\n const label = /^\\d+$/.test(ref) ? `#${ref}` : ref;\n throw new Error(`${label} matches more than one work item; use its id instead: ${candidates}.`);\n}\n\n/** The stage the card is in and where its board lets it go next, as the board shows its move buttons. */\nfunction boardMoves(board: InstalledBoard | undefined, item: Card) {\n const stage = item.stages.length === 1 ? item.stages[0]! : undefined;\n const phase = board && stage !== undefined && Object.hasOwn(board.phases, stage) ? board.phases[stage] : undefined;\n if (!board || !phase || stage === undefined) return null;\n return {\n board: { key: board.id, name: board.name },\n stage: { key: stage, name: phase.name, kind: phase.kind },\n // A working stage runs its skill again when the card is moved to the stage it is in.\n canRerun: phase.kind === 'working',\n next: phase.nextPhases\n .filter(key => Object.hasOwn(board.phases, key))\n .map(key => ({ key, name: board.phases[key]!.name, kind: board.phases[key]!.kind })),\n };\n}\n\nexport function workItemNotFound(ref: string): Error {\n return new Error(`No work item ${ref} was found in this Factory.`);\n}\n\nfunction activeWorker(bindings: FactoryRunBindingRecord[], itemId: string) {\n const binding = bindings.find(candidate => candidate.workItemId === itemId && candidate.status === 'active');\n return binding ? { role: binding.role, sessionId: binding.sessionId } : null;\n}\n\n/** The card on its Factory board; null when the server has no public URL configured. */\nfunction workItemUrl(item: Card) {\n return (\n factoryWorkItemUrl({\n factoryProjectId: item.factoryProjectId,\n workItemId: item.id,\n }) ?? null\n );\n}\n\nfunction summarizeItem(item: Card, bindings: FactoryRunBindingRecord[]) {\n return {\n id: item.id,\n number: workItemNumber(item),\n title: truncate(item.title, MAX_TEXT),\n board: boardForWorkItem(item),\n stage: workItemStage(item),\n url: workItemUrl(item),\n activeWorker: activeWorker(bindings, item.id),\n requestedBy: item.createdBy,\n updatedAt: iso(item.updatedAt),\n };\n}\n\nfunction summarizeDecision(decision: FactoryDeferredDecisionRecord, overtaken = false) {\n const type = typeof decision.decision.type === 'string' ? decision.decision.type : 'decision';\n const role = typeof decision.decision.role === 'string' ? decision.decision.role : null;\n return {\n id: decision.id,\n workItemId: decision.workItemId,\n type,\n role,\n status: decision.status,\n attempts: decision.attempts,\n failureCode: decision.failureCode,\n failureLabel: decision.failureCode ? factoryDispatchFailureMetadata(decision.failureCode).label : null,\n canRetry: decisionRetryable(decision, overtaken),\n error: decision.lastError ? truncate(decision.lastError, MAX_ERROR) : null,\n approvedBy: decision.approvedBy,\n updatedAt: iso(decision.updatedAt),\n };\n}\n\n/**\n * Held: a card triage left resting (or whose source asks for approval), until a person moves it\n * on. A card that has been past triage since (parked by self-review, or dragged back) resumes\n * instead, matching the board's held state.\n */\nfunction isHeld(boards: BoardRegistry, item: Card): boolean {\n const board = boards.get(boardForWorkItem(item));\n const stage = item.stages.length === 1 ? item.stages[0]! : undefined;\n if (!board || !stage || board.phaseKind(stage) !== 'resting') return false;\n if (needsApproval(item, phase => awaitsAcceptance(board, phase))) return true;\n const triage = boardFlow(board).triage;\n const triageRole = triage ? board.roleForPhase(triage) : undefined;\n if (!triageRole || item.sessions[triageRole] === undefined) return false;\n return !item.stageHistory.some(entry => entry.stage !== triage && board.isWorking(entry.stage));\n}\n\nconst listInputSchema = z\n .object({\n query: z\n .string()\n .trim()\n .min(1)\n .max(200)\n .optional()\n .describe(\n 'Case-insensitive text in the title, an exact card number like \"#123\", or the link, owner/repo#123 or key (ENG-42) of an issue or pull request, which finds the cards tracking it.',\n ),\n stage: z\n .string()\n .min(1)\n .max(64)\n .optional()\n .describe(\n 'Only items in this stage, by its key as items list it (e.g. \"intake\" or \"planning\"); a board\\'s review stage key can differ from its name.',\n ),\n board: z.string().min(1).max(64).optional().describe('Only items on this board, by its key, e.g. \"work\".'),\n role: z.string().min(1).max(64).optional().describe('Only items that have a session for this role.'),\n active: z.boolean().optional().describe('true: only items with an agent working now; false: only idle items.'),\n requestedBy: z.literal('me').optional().describe('\"me\": only items you filed.'),\n subscribed: z\n .boolean()\n .optional()\n .describe('true: only items this session follows; false: only items it does not.'),\n limit: z.number().int().min(1).max(MAX_LIST).optional().describe(`Default ${DEFAULT_LIST}, max ${MAX_LIST}.`),\n })\n .strict();\n\nexport function createFactoryReadTools(scope: FactoryToolScope, deps: FactoryReadToolDependencies): IntegrationTools {\n const project = { orgId: scope.orgId, factoryProjectId: scope.factoryProjectId };\n return {\n factory_list_work_items: createTool({\n id: 'factory_list_work_items',\n description:\n \"List this Factory's work items, newest activity first, with counts per stage for the whole Factory. Filter by text or #number, stage, board, role, whether an agent is working on it, items you filed, or items this session follows. Check here for an existing item before filing a new one.\",\n inputSchema: listInputSchema,\n execute: async input => {\n const [items, bindings, followed] = await Promise.all([\n deps.workItems.listShared(project),\n deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId),\n input.subscribed === undefined\n ? undefined\n : deps.workItems.listSessionSubscriptions({ ...project, sessionId: scope.sessionId }),\n ]);\n const followedIds = new Set(followed?.map(subscription => subscription.workItemId));\n const byStage: Record<string, number> = {};\n for (const item of items) {\n const stage = workItemStage(item);\n byStage[stage] = (byStage[stage] ?? 0) + 1;\n }\n const numberQuery = input.query ? /^#(\\d+)$/.exec(input.query)?.[1] : undefined;\n // A pasted link or owner/repo#123 finds the cards tracking that issue or pull request, not titles.\n const sourceQuery =\n input.query && numberQuery === undefined && sourceKeyFromReference(input.query) !== null\n ? input.query\n : undefined;\n const text = input.query?.toLowerCase();\n const matches = items\n .filter(item => {\n if (numberQuery !== undefined) {\n if (workItemNumber(item) !== Number(numberQuery)) return false;\n } else if (sourceQuery !== undefined) {\n if (!cardCarries(item, sourceQuery)) return false;\n } else if (text && !item.title.toLowerCase().includes(text)) return false;\n if (input.stage && !item.stages.includes(input.stage)) return false;\n if (input.board && boardForWorkItem(item) !== input.board) return false;\n if (input.role && !item.sessions[input.role]) return false;\n if (input.active !== undefined && (activeWorker(bindings, item.id) !== null) !== input.active) return false;\n if (input.requestedBy === 'me' && item.createdBy !== scope.userId) return false;\n if (input.subscribed !== undefined && followedIds.has(item.id) !== input.subscribed) return false;\n return true;\n })\n .sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime());\n const limit = input.limit ?? DEFAULT_LIST;\n return {\n counts: { total: items.length, byStage },\n items: matches.slice(0, limit).map(item => summarizeItem(item, bindings)),\n truncated: matches.length > limit,\n };\n },\n }),\n\n factory_inspect_work_item: createTool({\n id: 'factory_inspect_work_item',\n description:\n 'Everything the Factory knows about one work item: its description, the stages its board lets it move to next, stage history, sessions by role (with whether each is mid-run and when its thread last moved), decisions with errors, recent audit events, labels, linked items and the sessions following it. Use it to explain why an item is where it is, and to pick the stage key factory_transition_work_item takes.',\n inputSchema: z.object({ workItem: workItemRefSchema }).strict(),\n execute: async ({ workItem }) => {\n const item = await findWorkItem(deps.workItems, scope, workItem);\n if (!item) throw workItemNotFound(workItem);\n const [bindings, decisions, audit, all, subscribers] = await Promise.all([\n deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id),\n deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, { workItemId: item.id }),\n deps.audit.list({ ...project, limit: 200 }),\n deps.workItems.listShared(project),\n deps.workItems.listWorkItemSubscribers({ orgId: scope.orgId, workItemId: item.id }),\n ]);\n const itemDecisions = decisions.slice(-MAX_LIST);\n const boards = await toBoardSource(deps.boards).load(project);\n const overtaken = await overtakenDecisionIds(\n deps.workItems,\n boards,\n project,\n itemDecisions.filter(decision => decision.status === 'failed'),\n );\n const labels = Array.isArray(item.workItem.labels)\n ? item.workItem.labels.filter((label): label is string => typeof label === 'string').slice(0, MAX_LIST)\n : [];\n const parent = item.parentWorkItemId\n ? all.find(candidate => candidate.id === item.parentWorkItemId)\n : undefined;\n const children = all.filter(candidate => candidate.parentWorkItemId === item.id);\n const controller = (await deps.messaging?.())?.controller;\n const activity = async (sessionId: string, threadId: string): Promise<FactorySessionActivity | null> =>\n controller ? sessionActivity(controller, sessionId, threadId) : null;\n const sessions = await Promise.all(\n Object.entries(item.sessions).map(async ([role, ref]) => ({\n role,\n sessionId: ref.sessionId,\n threadId: ref.threadId,\n url:\n factorySessionUrl({\n factoryProjectId: item.factoryProjectId,\n sessionId: ref.sessionId,\n threadId: ref.threadId,\n }) ?? null,\n startedBy: ref.startedBy,\n active: bindings.some(\n binding => binding.role === role && binding.sessionId === ref.sessionId && binding.status === 'active',\n ),\n // `running` with an old `lastActivityAt` is a stuck run; `running` with a recent one is a long one.\n ...((await activity(ref.sessionId, ref.threadId)) ?? { running: null, lastActivityAt: null }),\n })),\n );\n return {\n item: {\n ...summarizeItem(item, bindings),\n description: item.description,\n source: item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : 'manual',\n sourceUrl: typeof item.workItem.url === 'string' ? item.workItem.url : null,\n revision: item.revision,\n },\n moves: boardMoves(boards.get(boardForWorkItem(item)), item),\n labels,\n stageHistory: item.stageHistory.slice(-MAX_LIST).map(entry => ({\n stage: entry.stage,\n enteredAt: entry.enteredAt,\n exitedAt: entry.exitedAt ?? null,\n by: entry.by,\n })),\n sessions,\n decisions: itemDecisions.map(decision => summarizeDecision(decision, overtaken.has(decision.id))),\n audit: audit.events\n .filter(event => event.targets.some(target => target.type === 'work_item' && target.id === item.id))\n .slice(0, 25)\n .map(event => ({\n action: event.action,\n actorId: event.actorId,\n actorType: event.actorType,\n occurredAt: iso(event.occurredAt),\n })),\n parent: parent ? summarizeItem(parent, bindings) : null,\n children: children.slice(0, MAX_LIST).map(child => summarizeItem(child, bindings)),\n subscribers: subscribers.slice(0, MAX_LIST).map(subscription => ({\n sessionId: subscription.sessionId,\n reason: subscription.reason,\n isCaller: subscription.sessionId === scope.sessionId,\n })),\n };\n },\n }),\n\n factory_list_attention: createTool({\n id: 'factory_list_attention',\n description:\n 'What in this Factory needs a person: failed decisions grouped by failure code and error (one incident per group), proposals waiting for approval, runs parked on a tool prompt (a plan to review, a question to answer) while still in flight, and Work cards triage left in Intake for a person to move on.',\n inputSchema: z.object({ limit: z.number().int().min(1).max(MAX_LIST).optional() }).strict(),\n execute: async ({ limit = DEFAULT_LIST }) => {\n const [decisions, items] = await Promise.all([\n deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, {\n statuses: ['failed', 'proposed'],\n }),\n deps.workItems.listShared(project),\n ]);\n const itemsById = new Map(items.map(item => [item.id, item]));\n const failed = decisions.filter(decision => decision.status === 'failed');\n const groups = new Map<\n string,\n { failureCode: string; error: string; decisions: FactoryDeferredDecisionRecord[] }\n >();\n for (const decision of failed) {\n const error = truncate(decision.lastError ?? '', MAX_ERROR);\n const key = `${decision.failureCode ?? 'unknown'}|${error}`;\n const group = groups.get(key) ?? { failureCode: decision.failureCode ?? 'unknown', error, decisions: [] };\n group.decisions.push(decision);\n groups.set(key, group);\n }\n const ref = (workItemId: string | null) => {\n const item = workItemId ? itemsById.get(workItemId) : undefined;\n return {\n workItemId,\n number: item ? workItemNumber(item) : null,\n title: item ? truncate(item.title, MAX_TEXT) : null,\n url: item ? workItemUrl(item) : null,\n };\n };\n const allIncidents = [...groups.values()].sort((a, b) => b.decisions.length - a.decisions.length);\n const incidents = allIncidents\n .slice(0, limit)\n .map(group => ({ ...group, shown: group.decisions.slice(0, limit) }));\n // Check exactly the decisions this call returns, so every canRetry is real.\n const boards = await toBoardSource(deps.boards).load(project);\n const overtaken = await overtakenDecisionIds(\n deps.workItems,\n boards,\n project,\n incidents.flatMap(group => group.shown),\n );\n const proposals = decisions.filter(decision => decision.status === 'proposed');\n const held = items.filter(item => isHeld(boards, item));\n const waiting = (deps.liveSessions?.()?.parkedIn(scope.factoryProjectId) ?? []).sort(\n (a, b) => a.run.suspendedAt - b.run.suspendedAt,\n );\n return {\n incidents: incidents.map(group => ({\n failureCode: group.failureCode,\n failureLabel: factoryDispatchFailureMetadata(group.decisions[0]!.failureCode).label,\n error: group.error,\n count: group.decisions.length,\n decisions: group.shown.map(decision => ({\n id: decision.id,\n ...ref(decision.workItemId),\n attempts: decision.attempts,\n canRetry: decisionRetryable(decision, overtaken.has(decision.id)),\n })),\n })),\n proposals: proposals\n .slice(0, limit)\n .map(decision => ({ ...summarizeDecision(decision), ...ref(decision.workItemId) })),\n waiting: waiting.slice(0, limit).map(({ sessionId, run }) => ({\n sessionId,\n toolName: run.toolName,\n label: parkedRunLabel(run.toolName),\n waitingSince: new Date(run.suspendedAt).toISOString(),\n })),\n held: held.slice(0, limit).map(item => ({\n ...ref(item.id),\n stage: workItemStage(item),\n })),\n truncated:\n allIncidents.length > limit ||\n incidents.some(group => group.shown.length < group.decisions.length) ||\n proposals.length > limit ||\n waiting.length > limit ||\n held.length > limit,\n };\n },\n }),\n };\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
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,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE/E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAA6B,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAYzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,mDAAmD;IACnD,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC3C,6DAA6D;IAC7D,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oFAAoF;IACpF,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAC5E,kGAAkG;IAClG,aAAa,EAAE,aAAa,CAAC;IAC7B,qGAAqG;IACrG,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,CAAC;CAC3E;
|
|
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,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE/E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAA6B,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAYzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,mDAAmD;IACnD,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC3C,6DAA6D;IAC7D,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oFAAoF;IACpF,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAC5E,kGAAkG;IAClG,aAAa,EAAE,aAAa,CAAC;IAC7B,qGAAqG;IACrG,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,CAAC;CAC3E;AAqCD,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,+BAA+B,GACpC,gBAAgB,CA8ZlB"}
|
|
@@ -30,7 +30,6 @@ function briefItem(item) {
|
|
|
30
30
|
stage: workItemStage(item),
|
|
31
31
|
url: factoryWorkItemUrl({
|
|
32
32
|
factoryProjectId: item.factoryProjectId,
|
|
33
|
-
board: boardForWorkItem(item),
|
|
34
33
|
workItemId: item.id
|
|
35
34
|
}) ?? null
|
|
36
35
|
};
|
|
@@ -114,7 +113,6 @@ function createFactoryWorkItemTools(scope, deps) {
|
|
|
114
113
|
if (!item) return result;
|
|
115
114
|
url = factoryWorkItemUrl({
|
|
116
115
|
factoryProjectId: item.factoryProjectId,
|
|
117
|
-
board: boardForWorkItem(item),
|
|
118
116
|
workItemId: item.id
|
|
119
117
|
}) ?? null;
|
|
120
118
|
await follow(item, "started");
|
|
@@ -203,7 +201,6 @@ function createFactoryWorkItemTools(scope, deps) {
|
|
|
203
201
|
};
|
|
204
202
|
const url = factoryWorkItemUrl({
|
|
205
203
|
factoryProjectId: item.factoryProjectId,
|
|
206
|
-
board: boardForWorkItem(item),
|
|
207
204
|
workItemId: item.id
|
|
208
205
|
}) ?? null;
|
|
209
206
|
const sameStage = item.stages.length === 1 && item.stages[0] === stage;
|
|
@@ -1 +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';\nimport { boardForWorkItem } from '../boards/index.js';\n\nimport type { BoardRegistry } from '../boards/index.js';\nimport type { IntakeRoutesReader } from '../boards/intake-routing.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 { MAX_BOARD_IDENTIFIER_LENGTH } from '../rules/validation.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 { IntakeEvaluator } from '../storage/domains/boards/base.js';\nimport { WorkItemRelationError } from '../storage/domains/work-items/base.js';\nimport type { UpdateWorkItemInput, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { workItemNumber } from '../work-items/card-number.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 { MAX_TEXT, findWorkItem, workItemRefSchema, truncate, workItemNotFound, workItemStage } 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 /** The project's intake routes, which place a filed card. */\n intakeRoutes?: IntakeRoutesReader;\n /** Which evaluator places a filed card; the old `route-list` by default. */\n intakeEvaluator?: IntakeEvaluator;\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 /** 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: Card) {\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 workItemLabel(item: Card): string {\n const number = workItemNumber(item);\n return number === null ? `\"${item.title}\"` : `#${number}`;\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, item?: Pick<Card, 'metadata' | 'workItem'>) => {\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: {\n metadata: repository ? { repository } : (item?.metadata ?? null),\n workItem: item?.workItem ?? { metadata: null },\n },\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: Card, reason: 'created' | 'moved' | 'started' | '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 * Approving or retrying a run starts it from this session, so this session follows its card as a\n * move does: the run's report and anything it waits on reach this session, which can pass them on.\n * Only approval acts as the person; a retry keeps the run's original approver. The run has\n * started by now: a failed read or follow is reported with it, not instead of it.\n */\n const followStartedRun = async (result: ReturnType<typeof settled>) => {\n if (!result.workItemId) return result;\n let url: string | null = null;\n try {\n const item = await deps.workItems.getForProject(scope.orgId, scope.factoryProjectId, result.workItemId);\n if (!item) return result;\n url =\n factoryWorkItemUrl({\n factoryProjectId: item.factoryProjectId,\n board: boardForWorkItem(item),\n workItemId: item.id,\n }) ?? null;\n await follow(item, 'started');\n return { ...result, url };\n } catch (error) {\n return {\n ...result,\n url,\n warnings: [`This session does not follow it yet: ${error instanceof Error ? error.message : String(error)}`],\n };\n }\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 for the person you are working with, on the board the project's intake rules pick (or the board named). It enters its board's first phase, or the phase an intake rule names, and this session follows it. Check factory_list_work_items for an existing item first. When no intake rule takes it, the call is refused: ask the person which board it belongs on and call again with that board. Name the repository when you know it; a run on a card that names none determines it from the card.\",\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 description: z\n .string()\n .trim()\n .min(1)\n .max(8000)\n .describe('What needs doing and why; becomes the card description its runs start from.'),\n repository: repositorySchema.optional(),\n board: z\n .string()\n .trim()\n .min(1)\n .max(MAX_BOARD_IDENTIFIER_LENGTH)\n .optional()\n .describe(\"The board's key, when the person picked one; files it in that board's first phase.\"),\n })\n .strict(),\n execute: async ({ title, description, repository, board }) => {\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 intakeRoutes: deps.intakeRoutes,\n intakeEvaluator: deps.intakeEvaluator,\n audit,\n ...project,\n userId: scope.userId,\n ...(scope.actorProfile ? { origin: { actorProfile: scope.actorProfile } } : {}),\n input: {\n title,\n description,\n ...(board ? { board } : {}),\n ...(repository ? { metadata: { repository } } : {}),\n },\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 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, or with `rerun` run the stage it is already in again, as the person you are working with: the same requests the board's own move and Start buttons send.\",\n \"The board's rules decide whether the move is allowed and what it starts. The run it starts counts as approved by that person, so it does not wait in the approval queue. The result has the card's `url`, to link it where you report the move.\",\n 'Use it when someone asks for a card\\'s own stage work, such as \"review this pull request\" on a pull request that has a card: the card\\'s review is recorded on the card and posted on the pull request.',\n 'When the person asks for a side session, a review in this chat, or work the stage does not do (pushing fixes to a pull request, taking it over), do that instead.',\n ].join(' '),\n inputSchema: z\n .object({\n workItem: workItemRefSchema,\n stage: z\n .string()\n .trim()\n .min(1)\n .max(64)\n .describe('Destination stage key, as factory_inspect_work_item lists it (e.g. \"planning\" or \"done\").'),\n rerun: z\n .boolean()\n .optional()\n .describe(\n \"With the stage the card is already in: run it again, as the board's Start button does. Without it, a request for the card's own stage changes nothing and says what the stage is doing.\",\n ),\n })\n .strict(),\n execute: async ({ workItem, stage, rerun: rerunRequested }) => {\n if (!deps.transitionService) throw new Error('Factory stage transitions are not available right now.');\n const item = await requireItem(workItem);\n // Following the card is what lets this session hear when its run waits on someone, and\n // answer it from here. It comes after the request: a failed follow is reported with it.\n const followed = async <T extends object>(result: T) => {\n try {\n await follow(item, 'moved');\n return result;\n } catch (error) {\n return {\n ...result,\n warnings: [\n `This session does not follow it yet: ${error instanceof Error ? error.message : String(error)}`,\n ],\n };\n }\n };\n // The card's page, so a chat can link the card it moved; null without a public URL.\n const url =\n factoryWorkItemUrl({\n factoryProjectId: item.factoryProjectId,\n board: boardForWorkItem(item),\n workItemId: item.id,\n }) ?? null;\n const sameStage = item.stages.length === 1 && item.stages[0] === stage;\n // Already there: report the stage instead of starting it again without being asked, which\n // would rerun a finished review or plan on a \"move it to review\".\n if (sameStage && rerunRequested !== true) {\n const held = (\n await deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, {\n workItemId: item.id,\n statuses: ['proposed'],\n })\n ).filter(decision => decision.decision.type === 'invokeSkill').length;\n return followed({\n workItemId: item.id,\n url,\n stage,\n revision: item.revision,\n unchanged: true,\n message:\n `${workItemLabel(item)} is already in ${stage}` +\n (held > 0 ? ', and its run there is waiting for approval.' : '.') +\n \" Pass rerun: true to run the stage again, as the board's Start button does; factory_inspect_work_item shows its sessions and runs.\",\n });\n }\n // The board's Start button sends the card's own stage with `reenter`; the rules decide the rest.\n const rerun = sameStage;\n // Rerunning starts a run approved by whoever asks, so like the button it needs a person.\n if (rerun && !scope.interactive) {\n throw new Error(\n `Running ${stage} again on ${workItemLabel(item)} needs a person in this turn: ask them to request it from a signed-in chat or the board.`,\n );\n }\n const parsed = transitionBodySchema.safeParse({\n board: boardForWorkItem(item),\n stage,\n expectedRevision: item.revision,\n requestId: randomUUID(),\n cause: 'factory_tools',\n ...(rerun ? { reenter: true } : {}),\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 // The move can start a phase session the Factory owns; the card has moved by now.\n return followed({\n workItemId: item.id,\n url,\n stage: result.stage,\n revision: result.revision,\n ...(rerun ? { reran: true } : {}),\n });\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, description, the repository its runs use, or its parent item. Move stages, or rerun the stage a card is in, with factory_transition_work_item.\",\n inputSchema: z\n .object({\n workItem: workItemRefSchema,\n title: z.string().trim().min(1).max(500).optional().describe('New card title.'),\n description: z\n .string()\n .trim()\n .max(8000)\n .optional()\n .describe('New card description; an empty string clears it.'),\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 })\n .strict()\n .refine(input => Object.keys(input).some(key => key !== 'workItem'), 'Pass at least one field to change.'),\n execute: async ({ workItem, title, description, repository, parentWorkItem }) => {\n const item = await requireItem(workItem);\n if (repository) await requireRepository(repository, item);\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 ...(description !== undefined ? { description: description || null } : {}),\n ...(repository ? { metadata: { repository } } : {}),\n ...(parentWorkItemId !== undefined ? { parentWorkItemId } : {}),\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 ...(description !== undefined ? ['description'] : []),\n ...(repository ? ['metadata'] : []),\n ...(parentWorkItemId !== undefined ? ['parentWorkItemId'] : []),\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 };\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. This session follows the run's card, so it hears how the run ends; the result has the card's `url`.\",\n inputSchema: z.object({ decisionId }).strict(),\n execute: async ({ decisionId }) =>\n followStartedRun(\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\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, and this session follows the run's card, so it hears how the run ends; the result has the card's `url`.\",\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 const result = settled(\n await resolveFactoryProposal({\n workItems: deps.workItems,\n audit,\n ...project,\n userId: scope.userId,\n decisionId,\n action,\n }),\n );\n return action === 'approve' ? followStartedRun(result) : result;\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 ...project,\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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"}
|
|
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';\nimport { boardForWorkItem } from '../boards/index.js';\n\nimport type { BoardRegistry } from '../boards/index.js';\nimport type { IntakeRoutesReader } from '../boards/intake-routing.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 { MAX_BOARD_IDENTIFIER_LENGTH } from '../rules/validation.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 { IntakeEvaluator } from '../storage/domains/boards/base.js';\nimport { WorkItemRelationError } from '../storage/domains/work-items/base.js';\nimport type { UpdateWorkItemInput, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { workItemNumber } from '../work-items/card-number.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 { MAX_TEXT, findWorkItem, workItemRefSchema, truncate, workItemNotFound, workItemStage } 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 /** The project's intake routes, which place a filed card. */\n intakeRoutes?: IntakeRoutesReader;\n /** Which evaluator places a filed card; the old `route-list` by default. */\n intakeEvaluator?: IntakeEvaluator;\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 /** 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: Card) {\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 workItemId: item.id,\n }) ?? null,\n };\n}\n\nfunction workItemLabel(item: Card): string {\n const number = workItemNumber(item);\n return number === null ? `\"${item.title}\"` : `#${number}`;\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, item?: Pick<Card, 'metadata' | 'workItem'>) => {\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: {\n metadata: repository ? { repository } : (item?.metadata ?? null),\n workItem: item?.workItem ?? { metadata: null },\n },\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: Card, reason: 'created' | 'moved' | 'started' | '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 * Approving or retrying a run starts it from this session, so this session follows its card as a\n * move does: the run's report and anything it waits on reach this session, which can pass them on.\n * Only approval acts as the person; a retry keeps the run's original approver. The run has\n * started by now: a failed read or follow is reported with it, not instead of it.\n */\n const followStartedRun = async (result: ReturnType<typeof settled>) => {\n if (!result.workItemId) return result;\n let url: string | null = null;\n try {\n const item = await deps.workItems.getForProject(scope.orgId, scope.factoryProjectId, result.workItemId);\n if (!item) return result;\n url =\n factoryWorkItemUrl({\n factoryProjectId: item.factoryProjectId,\n workItemId: item.id,\n }) ?? null;\n await follow(item, 'started');\n return { ...result, url };\n } catch (error) {\n return {\n ...result,\n url,\n warnings: [`This session does not follow it yet: ${error instanceof Error ? error.message : String(error)}`],\n };\n }\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 for the person you are working with, on the board the project's intake rules pick (or the board named). It enters its board's first phase, or the phase an intake rule names, and this session follows it. Check factory_list_work_items for an existing item first. When no intake rule takes it, the call is refused: ask the person which board it belongs on and call again with that board. Name the repository when you know it; a run on a card that names none determines it from the card.\",\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 description: z\n .string()\n .trim()\n .min(1)\n .max(8000)\n .describe('What needs doing and why; becomes the card description its runs start from.'),\n repository: repositorySchema.optional(),\n board: z\n .string()\n .trim()\n .min(1)\n .max(MAX_BOARD_IDENTIFIER_LENGTH)\n .optional()\n .describe(\"The board's key, when the person picked one; files it in that board's first phase.\"),\n })\n .strict(),\n execute: async ({ title, description, repository, board }) => {\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 intakeRoutes: deps.intakeRoutes,\n intakeEvaluator: deps.intakeEvaluator,\n audit,\n ...project,\n userId: scope.userId,\n ...(scope.actorProfile ? { origin: { actorProfile: scope.actorProfile } } : {}),\n input: {\n title,\n description,\n ...(board ? { board } : {}),\n ...(repository ? { metadata: { repository } } : {}),\n },\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 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, or with `rerun` run the stage it is already in again, as the person you are working with: the same requests the board's own move and Start buttons send.\",\n \"The board's rules decide whether the move is allowed and what it starts. The run it starts counts as approved by that person, so it does not wait in the approval queue. The result has the card's `url`, to link it where you report the move.\",\n 'Use it when someone asks for a card\\'s own stage work, such as \"review this pull request\" on a pull request that has a card: the card\\'s review is recorded on the card and posted on the pull request.',\n 'When the person asks for a side session, a review in this chat, or work the stage does not do (pushing fixes to a pull request, taking it over), do that instead.',\n ].join(' '),\n inputSchema: z\n .object({\n workItem: workItemRefSchema,\n stage: z\n .string()\n .trim()\n .min(1)\n .max(64)\n .describe('Destination stage key, as factory_inspect_work_item lists it (e.g. \"planning\" or \"done\").'),\n rerun: z\n .boolean()\n .optional()\n .describe(\n \"With the stage the card is already in: run it again, as the board's Start button does. Without it, a request for the card's own stage changes nothing and says what the stage is doing.\",\n ),\n })\n .strict(),\n execute: async ({ workItem, stage, rerun: rerunRequested }) => {\n if (!deps.transitionService) throw new Error('Factory stage transitions are not available right now.');\n const item = await requireItem(workItem);\n // Following the card is what lets this session hear when its run waits on someone, and\n // answer it from here. It comes after the request: a failed follow is reported with it.\n const followed = async <T extends object>(result: T) => {\n try {\n await follow(item, 'moved');\n return result;\n } catch (error) {\n return {\n ...result,\n warnings: [\n `This session does not follow it yet: ${error instanceof Error ? error.message : String(error)}`,\n ],\n };\n }\n };\n // The card's page, so a chat can link the card it moved; null without a public URL.\n const url =\n factoryWorkItemUrl({\n factoryProjectId: item.factoryProjectId,\n workItemId: item.id,\n }) ?? null;\n const sameStage = item.stages.length === 1 && item.stages[0] === stage;\n // Already there: report the stage instead of starting it again without being asked, which\n // would rerun a finished review or plan on a \"move it to review\".\n if (sameStage && rerunRequested !== true) {\n const held = (\n await deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, {\n workItemId: item.id,\n statuses: ['proposed'],\n })\n ).filter(decision => decision.decision.type === 'invokeSkill').length;\n return followed({\n workItemId: item.id,\n url,\n stage,\n revision: item.revision,\n unchanged: true,\n message:\n `${workItemLabel(item)} is already in ${stage}` +\n (held > 0 ? ', and its run there is waiting for approval.' : '.') +\n \" Pass rerun: true to run the stage again, as the board's Start button does; factory_inspect_work_item shows its sessions and runs.\",\n });\n }\n // The board's Start button sends the card's own stage with `reenter`; the rules decide the rest.\n const rerun = sameStage;\n // Rerunning starts a run approved by whoever asks, so like the button it needs a person.\n if (rerun && !scope.interactive) {\n throw new Error(\n `Running ${stage} again on ${workItemLabel(item)} needs a person in this turn: ask them to request it from a signed-in chat or the board.`,\n );\n }\n const parsed = transitionBodySchema.safeParse({\n board: boardForWorkItem(item),\n stage,\n expectedRevision: item.revision,\n requestId: randomUUID(),\n cause: 'factory_tools',\n ...(rerun ? { reenter: true } : {}),\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 // The move can start a phase session the Factory owns; the card has moved by now.\n return followed({\n workItemId: item.id,\n url,\n stage: result.stage,\n revision: result.revision,\n ...(rerun ? { reran: true } : {}),\n });\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, description, the repository its runs use, or its parent item. Move stages, or rerun the stage a card is in, with factory_transition_work_item.\",\n inputSchema: z\n .object({\n workItem: workItemRefSchema,\n title: z.string().trim().min(1).max(500).optional().describe('New card title.'),\n description: z\n .string()\n .trim()\n .max(8000)\n .optional()\n .describe('New card description; an empty string clears it.'),\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 })\n .strict()\n .refine(input => Object.keys(input).some(key => key !== 'workItem'), 'Pass at least one field to change.'),\n execute: async ({ workItem, title, description, repository, parentWorkItem }) => {\n const item = await requireItem(workItem);\n if (repository) await requireRepository(repository, item);\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 ...(description !== undefined ? { description: description || null } : {}),\n ...(repository ? { metadata: { repository } } : {}),\n ...(parentWorkItemId !== undefined ? { parentWorkItemId } : {}),\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 ...(description !== undefined ? ['description'] : []),\n ...(repository ? ['metadata'] : []),\n ...(parentWorkItemId !== undefined ? ['parentWorkItemId'] : []),\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 };\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. This session follows the run's card, so it hears how the run ends; the result has the card's `url`.\",\n inputSchema: z.object({ decisionId }).strict(),\n execute: async ({ decisionId }) =>\n followStartedRun(\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\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, and this session follows the run's card, so it hears how the run ends; the result has the card's `url`.\",\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 const result = settled(\n await resolveFactoryProposal({\n workItems: deps.workItems,\n audit,\n ...project,\n userId: scope.userId,\n decisionId,\n action,\n }),\n );\n return action === 'approve' ? followStartedRun(result) : result;\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 ...project,\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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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-work-item.d.ts","sourceRoot":"","sources":["../../src/work-items/create-work-item.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACzG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAGzG,4GAA4G;AAC5G,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAepF,MAAM,MAAM,2BAA2B;AACrC,oEAAoE;AAClE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE;AACnC,wGAAwG;GACtG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAChC;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EACA,eAAe,GACf,8BAA8B,GAC9B,iCAAiC;IACnC,yEAAyE;OACvE,uBAAuB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AACH,sKAAsK;GACpK;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5G,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAC5E,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,sFAAsF;IACtF,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,iGAAiG;IACjG,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;CACrE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,KAAK,EACL,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,eAAe,EACf,MAAM,GACP,EAAE,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC,
|
|
1
|
+
{"version":3,"file":"create-work-item.d.ts","sourceRoot":"","sources":["../../src/work-items/create-work-item.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACzG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAGzG,4GAA4G;AAC5G,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAepF,MAAM,MAAM,2BAA2B;AACrC,oEAAoE;AAClE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE;AACnC,wGAAwG;GACtG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAChC;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EACA,eAAe,GACf,8BAA8B,GAC9B,iCAAiC;IACnC,yEAAyE;OACvE,uBAAuB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AACH,sKAAsK;GACpK;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5G,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAC5E,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,sFAAsF;IACtF,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,iGAAiG;IACjG,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;CACrE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,KAAK,EACL,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,eAAe,EACf,MAAM,GACP,EAAE,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAqMlE"}
|
|
@@ -204,7 +204,8 @@ async function createFactoryWorkItem({ workItems, boards, transitionService, aud
|
|
|
204
204
|
type: "rule",
|
|
205
205
|
identity: `work-item:${id}:intake-route`
|
|
206
206
|
},
|
|
207
|
-
cause: "work_item_created"
|
|
207
|
+
cause: "work_item_created",
|
|
208
|
+
routeFiling: true
|
|
208
209
|
});
|
|
209
210
|
if (!moved) return notFound;
|
|
210
211
|
if (moved.status === "rejected") {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-work-item.js","names":[],"sources":["../../src/work-items/create-work-item.ts"],"sourcesContent":["/**\n * Filing a work item, shared by the board's create route and the Factory tools\n * so a card filed from a session goes through exactly what \"New card\" does.\n */\n\nimport { cardRuleFacts } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport { INTAKE_ROUTE_METADATA_KEY, projectIntakeEvaluator, resolveIntake } from '../boards/intake-routing.js';\nimport type { IntakeRoutesReader } from '../boards/intake-routing.js';\nimport type { FactoryTransitionRequest, FactoryTransitionService } from '../rules/transition-service.js';\nimport type { EmitAuditInput } from '../storage/domains/audit/domain.js';\nimport type { IntakeEvaluator } from '../storage/domains/boards/base.js';\nimport { WorkItemUpdateConflictError } from '../storage/domains/work-items/base.js';\nimport type { CreateWorkItemInput, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { CARD_NUMBER_METADATA_KEY } from './card-number.js';\n\n/** Records one audit event for the caller; routes bind it to the request, tools to the session's person. */\nexport type FactoryAuditEmit = (input: EmitAuditInput) => Promise<void>;\n\ntype TransitionResult = Awaited<ReturnType<FactoryTransitionService['transition']>>;\n\n/** Attempts at each step after the upsert before a card that keeps changing under its creator is left as is. */\nconst STEP_ATTEMPTS = 3;\n\n/** One past the highest number given to a manually filed card in the project. */\nasync function nextCardNumber(workItems: WorkItemsStorage, orgId: string, factoryProjectId: string): Promise<number> {\n let highest = 0;\n for (const card of await workItems.listShared({ orgId, factoryProjectId })) {\n const number = card.metadata?.[CARD_NUMBER_METADATA_KEY];\n if (typeof number === 'number' && number > highest) highest = number;\n }\n return highest + 1;\n}\n\nexport type CreateFactoryWorkItemResult =\n /** A new card, entered into its board's first phase and audited. */\n | { status: 'created'; item: Card }\n /** The source key matched an existing card, which was updated instead (the caller audits the patch). */\n | { status: 'reused'; item: Card }\n | {\n status: 'refused';\n code:\n | 'invalid_board'\n | 'governed_transition_required'\n | 'factory_transitions_unavailable'\n /** No board's intake rules take the card; the person names the board. */\n | 'intake_board_required';\n message: string;\n }\n /** The first phase's entry rules (or the move to an intake route's phase) refused the card; it was removed again unless a concurrent create had already reused it. */\n | { status: 'rejected'; code: Extract<TransitionResult, { status: 'rejected' }>['code']; reason: string };\n\nexport interface CreateFactoryWorkItemArgs {\n workItems: WorkItemsStorage;\n boards: BoardRegistry;\n transitionService: Pick<FactoryTransitionService, 'transition'> | undefined;\n audit: FactoryAuditEmit;\n orgId: string;\n /** Who files the card; becomes its `created_by` and the human actor of its first phase entry. */\n userId: string;\n factoryProjectId: string;\n input: CreateWorkItemInput;\n /** The project's intake routes; they place a card filed without a board or stages. */\n intakeRoutes?: IntakeRoutesReader;\n /** Forces the evaluator that places a card filed without a board; else the project's setting. */\n intakeEvaluator?: IntakeEvaluator;\n /** Where a browser request came from; a session's tool call carries none. */\n origin?: Pick<FactoryTransitionRequest, 'actorProfile' | 'context'>;\n}\n\n/**\n * Upserts the card into its board's first phase, enters that phase as the\n * person (rolling the card back if its entry rules refuse it), then audits\n * `factory.work_item.created`. Throws `WorkItemRelationError` for a bad parent.\n */\nexport async function createFactoryWorkItem({\n workItems,\n boards,\n transitionService,\n audit,\n orgId,\n userId,\n factoryProjectId,\n input,\n intakeRoutes,\n intakeEvaluator,\n origin,\n}: CreateFactoryWorkItemArgs): Promise<CreateFactoryWorkItemResult> {\n // A card filed without a board goes where intake says; one that names a board went where the\n // person chose. Under the old evaluator a card naming its stages skips the rules too.\n let boardId = input.board;\n let placement: { phase: string; routeId: string } | undefined;\n const unavailable = {\n status: 'refused',\n code: 'intake_board_required',\n message: 'Intake rules are unavailable right now. Pick the board to file it on.',\n } as const;\n // Without the project's setting nothing says it may use the route list's first-board fallback.\n if (boardId === undefined && !intakeRoutes && intakeEvaluator !== 'route-list') return unavailable;\n if (boardId === undefined) {\n const scope = { orgId, factoryProjectId };\n let evaluator: IntakeEvaluator;\n try {\n evaluator = intakeRoutes ? await projectIntakeEvaluator(intakeEvaluator, intakeRoutes, scope) : 'route-list';\n } catch {\n return unavailable;\n }\n const routed = intakeRoutes && (evaluator === 'intake-order' || input.stages === undefined);\n const [routes, order] = routed\n ? await Promise.all([\n intakeRoutes.listIntakeRoutes(scope),\n evaluator === 'intake-order'\n ? intakeRoutes.readIntakeOrder(scope, { boards: [...boards.keys()] })\n : undefined,\n ])\n : [[], undefined];\n const resolution = resolveIntake({\n evaluator,\n routes,\n order: order?.boardKeys ?? [],\n facts: cardRuleFacts({\n title: input.title,\n metadata: input.metadata ?? null,\n externalSource: input.externalSource ?? null,\n }),\n registry: boards,\n });\n // No board's rules take it: the person picks the board.\n if (resolution.outcome === 'not_routed') {\n return {\n status: 'refused',\n code: 'intake_board_required',\n message: `${resolution.reason} Pick the board to file it on.`,\n };\n }\n boardId = resolution.board;\n // Named stages keep the card in the board's first phase; the rule only picked the board.\n if (resolution.routeId !== null && input.stages === undefined) {\n placement = { phase: resolution.phase, routeId: resolution.routeId };\n }\n }\n const board = boards.get(boardId);\n if (!board) return { status: 'refused', code: 'invalid_board', message: `Board '${boardId}' is not installed.` };\n const initialStages = input.stages ?? [board.initialPhase];\n if (initialStages.length !== 1 || initialStages[0] !== board.initialPhase) {\n return {\n status: 'refused',\n code: 'governed_transition_required',\n message: `New work items must enter through the '${board.initialPhase}' phase of board '${boardId}'.`,\n };\n }\n\n await workItems.ensureReady();\n // A card with no issue behind it has no number of its own, so it gets the project's next one.\n const metadata = input.externalSource\n ? input.metadata\n : {\n ...input.metadata,\n [CARD_NUMBER_METADATA_KEY]: await nextCardNumber(workItems, orgId, factoryProjectId),\n };\n const result = await workItems.upsert({\n orgId,\n userId,\n factoryProjectId,\n input: {\n ...input,\n ...(metadata ? { metadata } : {}),\n board: boardId,\n stages: initialStages,\n },\n reuseMode: 'non-stage',\n });\n // A reused card keeps its own placement, so only a card this call created records the route.\n if (!result.created) return { status: 'reused', item: result.item };\n\n const id = result.item.id;\n // A concurrent create for the same source can reuse this card at any step below. That caller\n // has already returned it as `reused`, so a step that loses the revision race is retried at the\n // current revision, and the card is never rolled back once anyone else has touched it. A reuse\n // that only refreshes source facts keeps the revision but moves `updatedAt`, so the rollback\n // deletes only while both still match this call's last write.\n let revision: number | undefined = result.item.revision;\n let updatedAt = result.item.updatedAt;\n let contended = false;\n const reread = async () => {\n contended = true;\n revision = (await workItems.getForProject(orgId, factoryProjectId, id))?.revision;\n };\n const rollBack = async () => {\n if (contended || revision === undefined) return;\n await workItems.delete({ orgId, id, expectedRevision: revision, expectedUpdatedAt: updatedAt });\n };\n const notFound = { status: 'rejected', code: 'invalid_transition', reason: 'Work item not found.' } as const;\n\n if (placement) {\n for (let attempt = 1; revision !== undefined; attempt++) {\n try {\n const stamped = await workItems.update({\n orgId,\n id,\n userId,\n patch: { metadata: { [INTAKE_ROUTE_METADATA_KEY]: placement.routeId } },\n expectedRevision: revision,\n });\n revision = stamped?.item.revision;\n if (stamped) updatedAt = stamped.item.updatedAt;\n break;\n } catch (error) {\n const stale = error instanceof WorkItemUpdateConflictError && error.reason === 'revision';\n if (!stale || attempt >= STEP_ATTEMPTS) throw error;\n await reread();\n }\n }\n if (revision === undefined) return notFound;\n }\n if (!transitionService) {\n await rollBack();\n return {\n status: 'refused',\n code: 'factory_transitions_unavailable',\n message: 'Factory stage transitions are not available right now.',\n };\n }\n const transition = async (\n request: Omit<FactoryTransitionRequest, 'expectedRevision'>,\n ): Promise<TransitionResult | undefined> => {\n for (let attempt = 1; revision !== undefined; attempt++) {\n const transitioned = await transitionService.transition({ ...request, expectedRevision: revision });\n // The result carries no timestamp, so `updatedAt` stays at the last write this call saw; the\n // commit has moved the card past it, so a later rollback keeps the card instead of guessing.\n if (transitioned.status === 'accepted') revision = transitioned.revision;\n if (transitioned.status !== 'rejected' || transitioned.code !== 'stale' || attempt >= STEP_ATTEMPTS) {\n return transitioned;\n }\n await reread();\n }\n return undefined;\n };\n\n const entered = await transition({\n orgId,\n factoryProjectId,\n workItemId: id,\n board: boardId,\n stage: board.initialPhase,\n actor: { type: 'human', id: userId },\n ...origin,\n ingress: { type: 'human', identity: `work-item:${id}:initial-entry` },\n cause: 'work_item_created',\n initialEntry: true,\n });\n if (!entered) return notFound;\n if (entered.status === 'rejected') {\n await rollBack();\n return { status: 'rejected', code: entered.code, reason: entered.reason };\n }\n if (placement && placement.phase !== board.initialPhase) {\n const moved = await transition({\n orgId,\n factoryProjectId,\n workItemId: id,\n board: boardId,\n stage: placement.phase,\n // The route moves the card, not the person: a run it starts still needs their consent.\n actor: { type: 'system', id: 'factory-intake-route' },\n ingress: { type: 'rule', identity: `work-item:${id}:intake-route` },\n cause: 'work_item_created',\n });\n if (!moved) return notFound;\n if (moved.status === 'rejected') {\n await rollBack();\n return { status: 'rejected', code: moved.code, reason: moved.reason };\n }\n }\n const item = (await workItems.getForProject(orgId, factoryProjectId, id)) ?? result.item;\n await audit({\n action: 'factory.work_item.created',\n factoryProjectId,\n targets: [{ type: 'work_item', id: item.id, name: item.title }],\n metadata: { externalSource: item.externalSource, stages: item.stages },\n });\n return { status: 'created', item };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"create-work-item.js","names":[],"sources":["../../src/work-items/create-work-item.ts"],"sourcesContent":["/**\n * Filing a work item, shared by the board's create route and the Factory tools\n * so a card filed from a session goes through exactly what \"New card\" does.\n */\n\nimport { cardRuleFacts } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport { INTAKE_ROUTE_METADATA_KEY, projectIntakeEvaluator, resolveIntake } from '../boards/intake-routing.js';\nimport type { IntakeRoutesReader } from '../boards/intake-routing.js';\nimport type { FactoryTransitionRequest, FactoryTransitionService } from '../rules/transition-service.js';\nimport type { EmitAuditInput } from '../storage/domains/audit/domain.js';\nimport type { IntakeEvaluator } from '../storage/domains/boards/base.js';\nimport { WorkItemUpdateConflictError } from '../storage/domains/work-items/base.js';\nimport type { CreateWorkItemInput, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { CARD_NUMBER_METADATA_KEY } from './card-number.js';\n\n/** Records one audit event for the caller; routes bind it to the request, tools to the session's person. */\nexport type FactoryAuditEmit = (input: EmitAuditInput) => Promise<void>;\n\ntype TransitionResult = Awaited<ReturnType<FactoryTransitionService['transition']>>;\n\n/** Attempts at each step after the upsert before a card that keeps changing under its creator is left as is. */\nconst STEP_ATTEMPTS = 3;\n\n/** One past the highest number given to a manually filed card in the project. */\nasync function nextCardNumber(workItems: WorkItemsStorage, orgId: string, factoryProjectId: string): Promise<number> {\n let highest = 0;\n for (const card of await workItems.listShared({ orgId, factoryProjectId })) {\n const number = card.metadata?.[CARD_NUMBER_METADATA_KEY];\n if (typeof number === 'number' && number > highest) highest = number;\n }\n return highest + 1;\n}\n\nexport type CreateFactoryWorkItemResult =\n /** A new card, entered into its board's first phase and audited. */\n | { status: 'created'; item: Card }\n /** The source key matched an existing card, which was updated instead (the caller audits the patch). */\n | { status: 'reused'; item: Card }\n | {\n status: 'refused';\n code:\n | 'invalid_board'\n | 'governed_transition_required'\n | 'factory_transitions_unavailable'\n /** No board's intake rules take the card; the person names the board. */\n | 'intake_board_required';\n message: string;\n }\n /** The first phase's entry rules (or the move to an intake route's phase) refused the card; it was removed again unless a concurrent create had already reused it. */\n | { status: 'rejected'; code: Extract<TransitionResult, { status: 'rejected' }>['code']; reason: string };\n\nexport interface CreateFactoryWorkItemArgs {\n workItems: WorkItemsStorage;\n boards: BoardRegistry;\n transitionService: Pick<FactoryTransitionService, 'transition'> | undefined;\n audit: FactoryAuditEmit;\n orgId: string;\n /** Who files the card; becomes its `created_by` and the human actor of its first phase entry. */\n userId: string;\n factoryProjectId: string;\n input: CreateWorkItemInput;\n /** The project's intake routes; they place a card filed without a board or stages. */\n intakeRoutes?: IntakeRoutesReader;\n /** Forces the evaluator that places a card filed without a board; else the project's setting. */\n intakeEvaluator?: IntakeEvaluator;\n /** Where a browser request came from; a session's tool call carries none. */\n origin?: Pick<FactoryTransitionRequest, 'actorProfile' | 'context'>;\n}\n\n/**\n * Upserts the card into its board's first phase, enters that phase as the\n * person (rolling the card back if its entry rules refuse it), then audits\n * `factory.work_item.created`. Throws `WorkItemRelationError` for a bad parent.\n */\nexport async function createFactoryWorkItem({\n workItems,\n boards,\n transitionService,\n audit,\n orgId,\n userId,\n factoryProjectId,\n input,\n intakeRoutes,\n intakeEvaluator,\n origin,\n}: CreateFactoryWorkItemArgs): Promise<CreateFactoryWorkItemResult> {\n // A card filed without a board goes where intake says; one that names a board went where the\n // person chose. Under the old evaluator a card naming its stages skips the rules too.\n let boardId = input.board;\n let placement: { phase: string; routeId: string } | undefined;\n const unavailable = {\n status: 'refused',\n code: 'intake_board_required',\n message: 'Intake rules are unavailable right now. Pick the board to file it on.',\n } as const;\n // Without the project's setting nothing says it may use the route list's first-board fallback.\n if (boardId === undefined && !intakeRoutes && intakeEvaluator !== 'route-list') return unavailable;\n if (boardId === undefined) {\n const scope = { orgId, factoryProjectId };\n let evaluator: IntakeEvaluator;\n try {\n evaluator = intakeRoutes ? await projectIntakeEvaluator(intakeEvaluator, intakeRoutes, scope) : 'route-list';\n } catch {\n return unavailable;\n }\n const routed = intakeRoutes && (evaluator === 'intake-order' || input.stages === undefined);\n const [routes, order] = routed\n ? await Promise.all([\n intakeRoutes.listIntakeRoutes(scope),\n evaluator === 'intake-order'\n ? intakeRoutes.readIntakeOrder(scope, { boards: [...boards.keys()] })\n : undefined,\n ])\n : [[], undefined];\n const resolution = resolveIntake({\n evaluator,\n routes,\n order: order?.boardKeys ?? [],\n facts: cardRuleFacts({\n title: input.title,\n metadata: input.metadata ?? null,\n externalSource: input.externalSource ?? null,\n }),\n registry: boards,\n });\n // No board's rules take it: the person picks the board.\n if (resolution.outcome === 'not_routed') {\n return {\n status: 'refused',\n code: 'intake_board_required',\n message: `${resolution.reason} Pick the board to file it on.`,\n };\n }\n boardId = resolution.board;\n // Named stages keep the card in the board's first phase; the rule only picked the board.\n if (resolution.routeId !== null && input.stages === undefined) {\n placement = { phase: resolution.phase, routeId: resolution.routeId };\n }\n }\n const board = boards.get(boardId);\n if (!board) return { status: 'refused', code: 'invalid_board', message: `Board '${boardId}' is not installed.` };\n const initialStages = input.stages ?? [board.initialPhase];\n if (initialStages.length !== 1 || initialStages[0] !== board.initialPhase) {\n return {\n status: 'refused',\n code: 'governed_transition_required',\n message: `New work items must enter through the '${board.initialPhase}' phase of board '${boardId}'.`,\n };\n }\n\n await workItems.ensureReady();\n // A card with no issue behind it has no number of its own, so it gets the project's next one.\n const metadata = input.externalSource\n ? input.metadata\n : {\n ...input.metadata,\n [CARD_NUMBER_METADATA_KEY]: await nextCardNumber(workItems, orgId, factoryProjectId),\n };\n const result = await workItems.upsert({\n orgId,\n userId,\n factoryProjectId,\n input: {\n ...input,\n ...(metadata ? { metadata } : {}),\n board: boardId,\n stages: initialStages,\n },\n reuseMode: 'non-stage',\n });\n // A reused card keeps its own placement, so only a card this call created records the route.\n if (!result.created) return { status: 'reused', item: result.item };\n\n const id = result.item.id;\n // A concurrent create for the same source can reuse this card at any step below. That caller\n // has already returned it as `reused`, so a step that loses the revision race is retried at the\n // current revision, and the card is never rolled back once anyone else has touched it. A reuse\n // that only refreshes source facts keeps the revision but moves `updatedAt`, so the rollback\n // deletes only while both still match this call's last write.\n let revision: number | undefined = result.item.revision;\n let updatedAt = result.item.updatedAt;\n let contended = false;\n const reread = async () => {\n contended = true;\n revision = (await workItems.getForProject(orgId, factoryProjectId, id))?.revision;\n };\n const rollBack = async () => {\n if (contended || revision === undefined) return;\n await workItems.delete({ orgId, id, expectedRevision: revision, expectedUpdatedAt: updatedAt });\n };\n const notFound = { status: 'rejected', code: 'invalid_transition', reason: 'Work item not found.' } as const;\n\n if (placement) {\n for (let attempt = 1; revision !== undefined; attempt++) {\n try {\n const stamped = await workItems.update({\n orgId,\n id,\n userId,\n patch: { metadata: { [INTAKE_ROUTE_METADATA_KEY]: placement.routeId } },\n expectedRevision: revision,\n });\n revision = stamped?.item.revision;\n if (stamped) updatedAt = stamped.item.updatedAt;\n break;\n } catch (error) {\n const stale = error instanceof WorkItemUpdateConflictError && error.reason === 'revision';\n if (!stale || attempt >= STEP_ATTEMPTS) throw error;\n await reread();\n }\n }\n if (revision === undefined) return notFound;\n }\n if (!transitionService) {\n await rollBack();\n return {\n status: 'refused',\n code: 'factory_transitions_unavailable',\n message: 'Factory stage transitions are not available right now.',\n };\n }\n const transition = async (\n request: Omit<FactoryTransitionRequest, 'expectedRevision'>,\n ): Promise<TransitionResult | undefined> => {\n for (let attempt = 1; revision !== undefined; attempt++) {\n const transitioned = await transitionService.transition({ ...request, expectedRevision: revision });\n // The result carries no timestamp, so `updatedAt` stays at the last write this call saw; the\n // commit has moved the card past it, so a later rollback keeps the card instead of guessing.\n if (transitioned.status === 'accepted') revision = transitioned.revision;\n if (transitioned.status !== 'rejected' || transitioned.code !== 'stale' || attempt >= STEP_ATTEMPTS) {\n return transitioned;\n }\n await reread();\n }\n return undefined;\n };\n\n const entered = await transition({\n orgId,\n factoryProjectId,\n workItemId: id,\n board: boardId,\n stage: board.initialPhase,\n actor: { type: 'human', id: userId },\n ...origin,\n ingress: { type: 'human', identity: `work-item:${id}:initial-entry` },\n cause: 'work_item_created',\n initialEntry: true,\n });\n if (!entered) return notFound;\n if (entered.status === 'rejected') {\n await rollBack();\n return { status: 'rejected', code: entered.code, reason: entered.reason };\n }\n if (placement && placement.phase !== board.initialPhase) {\n const moved = await transition({\n orgId,\n factoryProjectId,\n workItemId: id,\n board: boardId,\n stage: placement.phase,\n // The route moves the card, not the person: a run it starts still needs their consent.\n actor: { type: 'system', id: 'factory-intake-route' },\n ingress: { type: 'rule', identity: `work-item:${id}:intake-route` },\n cause: 'work_item_created',\n // The route's target is admin-authored, so the first phase's next phases don't restrict it.\n routeFiling: true,\n });\n if (!moved) return notFound;\n if (moved.status === 'rejected') {\n await rollBack();\n return { status: 'rejected', code: moved.code, reason: moved.reason };\n }\n }\n const item = (await workItems.getForProject(orgId, factoryProjectId, id)) ?? result.item;\n await audit({\n action: 'factory.work_item.created',\n factoryProjectId,\n targets: [{ type: 'work_item', id: item.id, name: item.title }],\n metadata: { externalSource: item.externalSource, stages: item.stages },\n });\n return { status: 'created', item };\n}\n"],"mappings":"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"}
|
package/dist/workspace.d.ts
CHANGED
|
@@ -37,10 +37,14 @@ export declare const REVIEW_ONLY_FACTORY_SKILLS: Set<string>;
|
|
|
37
37
|
* The source still checks the live binding, so this never widens access.
|
|
38
38
|
*/
|
|
39
39
|
export declare function rescanFactorySkills(skills: NonNullable<Workspace['skills']>): Promise<void>;
|
|
40
|
-
/**
|
|
40
|
+
/**
|
|
41
|
+
* A project's SKILL.md for one skill: an edit served in place of the original's, or, with `created`, a skill
|
|
42
|
+
* the project added that is served even when the app has no skill of that name.
|
|
43
|
+
*/
|
|
41
44
|
export interface FactorySkillOverride {
|
|
42
45
|
content: string;
|
|
43
46
|
updatedAt: Date;
|
|
47
|
+
created?: boolean;
|
|
44
48
|
}
|
|
45
49
|
export declare class FactorySkillSource implements SkillSource {
|
|
46
50
|
#private;
|
package/dist/workspace.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAE/E,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,mCAAmC,CAAC;AAKtG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAoB,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAG1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAoC9E,OAAO,KAAK,EAAE,qBAAqB,EAA4C,MAAM,8BAA8B,CAAC;AAQpH,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,KAAK,EAAwB,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACjH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAW7E,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAIpD,eAAO,MAAM,2BAA2B,QAQQ,CAAC;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,GAAG,SAAS,CAY7F;AACD,eAAO,MAAM,oBAAoB,QAAgF,CAAC;AAClH,eAAO,MAAM,mBAAmB,aAU9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,aAMrC,CAAC;AASH;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CASjG;AAsCD
|
|
1
|
+
{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"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"}
|