@mastra/factory 0.28.0 → 0.29.0-alpha.0
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 +6 -4
- package/dist/boards/reroute.d.ts +31 -0
- package/dist/boards/reroute.d.ts.map +1 -0
- package/dist/boards/reroute.js +71 -0
- package/dist/boards/reroute.js.map +1 -0
- package/dist/environment/repository-access.d.ts +2 -0
- package/dist/environment/repository-access.d.ts.map +1 -1
- package/dist/environment/repository-access.js +9 -4
- package/dist/environment/repository-access.js.map +1 -1
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +9 -6
- package/dist/factory.js.map +1 -1
- package/dist/integrations/base.d.ts +8 -0
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/dependabot/default-rules.d.ts +38 -0
- package/dist/integrations/dependabot/default-rules.d.ts.map +1 -0
- package/dist/integrations/dependabot/default-rules.js +63 -0
- package/dist/integrations/dependabot/default-rules.js.map +1 -0
- package/dist/integrations/dependabot/rules.d.ts +42 -0
- package/dist/integrations/dependabot/rules.d.ts.map +1 -0
- package/dist/integrations/dependabot/rules.js +187 -0
- package/dist/integrations/dependabot/rules.js.map +1 -0
- package/dist/integrations/dependabot/sync.d.ts +76 -0
- package/dist/integrations/dependabot/sync.d.ts.map +1 -0
- package/dist/integrations/dependabot/sync.js +111 -0
- package/dist/integrations/dependabot/sync.js.map +1 -0
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +7 -2
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/sandbox.d.ts +12 -0
- package/dist/integrations/github/sandbox.d.ts.map +1 -1
- package/dist/integrations/github/sandbox.js +22 -1
- package/dist/integrations/github/sandbox.js.map +1 -1
- package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
- package/dist/integrations/platform/connect/routes.js +4 -0
- package/dist/integrations/platform/connect/routes.js.map +1 -1
- package/dist/integrations/platform/github/event-worker.d.ts +5 -0
- package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
- package/dist/integrations/platform/github/event-worker.js +33 -2
- package/dist/integrations/platform/github/event-worker.js.map +1 -1
- package/dist/integrations/platform/github/integration.d.ts +19 -1
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +46 -0
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/vanta/integration.d.ts +33 -0
- package/dist/integrations/platform/vanta/integration.d.ts.map +1 -0
- package/dist/integrations/platform/vanta/integration.js +133 -0
- package/dist/integrations/platform/vanta/integration.js.map +1 -0
- package/dist/integrations/vanta/default-rules.d.ts +34 -0
- package/dist/integrations/vanta/default-rules.d.ts.map +1 -0
- package/dist/integrations/vanta/default-rules.js +61 -0
- package/dist/integrations/vanta/default-rules.js.map +1 -0
- package/dist/integrations/vanta/rules.d.ts +40 -0
- package/dist/integrations/vanta/rules.d.ts.map +1 -0
- package/dist/integrations/vanta/rules.js +208 -0
- package/dist/integrations/vanta/rules.js.map +1 -0
- package/dist/integrations/vanta/sync.d.ts +36 -0
- package/dist/integrations/vanta/sync.d.ts.map +1 -0
- package/dist/integrations/vanta/sync.js +73 -0
- package/dist/integrations/vanta/sync.js.map +1 -0
- package/dist/mcp/routes.d.ts.map +1 -1
- package/dist/mcp/routes.js +1 -1
- package/dist/mcp/routes.js.map +1 -1
- package/dist/routes/board-snapshot.d.ts +8 -1
- package/dist/routes/board-snapshot.d.ts.map +1 -1
- package/dist/routes/board-snapshot.js +23 -2
- package/dist/routes/board-snapshot.js.map +1 -1
- package/dist/routes/contracts.d.ts +205 -0
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +159 -5
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/intake-routes.d.ts +3 -0
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +44 -0
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/knowledge.d.ts.map +1 -1
- package/dist/routes/knowledge.js +3 -2
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/source-control-sessions.d.ts +1 -1
- package/dist/routes/source-control-sessions.d.ts.map +1 -1
- package/dist/routes/source-control-sessions.js +109 -3
- package/dist/routes/source-control-sessions.js.map +1 -1
- package/dist/routes/surface.d.ts +6 -1
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +72 -9
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/work-item-selection.d.ts +0 -4
- package/dist/routes/work-item-selection.d.ts.map +1 -1
- package/dist/routes/work-item-selection.js +4 -21
- package/dist/routes/work-item-selection.js.map +1 -1
- package/dist/routes/work-item-starters.d.ts.map +1 -1
- package/dist/routes/work-item-starters.js +4 -21
- package/dist/routes/work-item-starters.js.map +1 -1
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +112 -36
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/dispatch-errors.d.ts +3 -0
- package/dist/rules/dispatch-errors.d.ts.map +1 -1
- package/dist/rules/dispatch-errors.js +5 -0
- package/dist/rules/dispatch-errors.js.map +1 -1
- package/dist/rules/dispatcher.d.ts +2 -0
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +39 -18
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/index.d.ts +2 -2
- package/dist/rules/index.d.ts.map +1 -1
- package/dist/rules/index.js +2 -2
- package/dist/rules/start-coordinator.d.ts +6 -1
- package/dist/rules/start-coordinator.d.ts.map +1 -1
- package/dist/rules/start-coordinator.js +6 -2
- package/dist/rules/start-coordinator.js.map +1 -1
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +3 -2
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +71 -3
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js +10 -2
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +5 -0
- package/dist/rules/validation.js.map +1 -1
- package/dist/session/factory-session.d.ts +20 -5
- package/dist/session/factory-session.d.ts.map +1 -1
- package/dist/session/factory-session.js +20 -6
- package/dist/session/factory-session.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 +2 -1
- package/dist/storage/domains/audit/actions.js.map +1 -1
- package/dist/storage/domains/audit/actors.d.ts.map +1 -1
- package/dist/storage/domains/audit/actors.js +1 -1
- package/dist/storage/domains/audit/actors.js.map +1 -1
- package/dist/storage/domains/intake/base.d.ts +1 -1
- package/dist/storage/domains/intake/base.js +2 -2
- package/dist/storage/domains/intake/base.js.map +1 -1
- package/dist/storage/domains/projects/base.d.ts +8 -0
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +11 -1
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/work-items/base.d.ts +15 -4
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +19 -1
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/tools/approval-tools.d.ts +20 -0
- package/dist/tools/approval-tools.d.ts.map +1 -1
- package/dist/tools/approval-tools.js +79 -30
- package/dist/tools/approval-tools.js.map +1 -1
- package/dist/tools/audit-events-tool.d.ts +1 -1
- package/dist/tools/messaging-tools.d.ts.map +1 -1
- package/dist/tools/messaging-tools.js +1 -1
- package/dist/tools/messaging-tools.js.map +1 -1
- package/dist/tools/read-tools.d.ts +0 -2
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +2 -7
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/reports.d.ts +3 -0
- package/dist/tools/reports.d.ts.map +1 -1
- package/dist/tools/reports.js +3 -3
- package/dist/tools/reports.js.map +1 -1
- package/dist/tools/run-watch.d.ts +14 -2
- package/dist/tools/run-watch.d.ts.map +1 -1
- package/dist/tools/run-watch.js +24 -4
- package/dist/tools/run-watch.js.map +1 -1
- package/dist/tools/session-tools.d.ts.map +1 -1
- package/dist/tools/session-tools.js +17 -6
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/side-sessions.d.ts.map +1 -1
- package/dist/tools/side-sessions.js +1 -1
- package/dist/tools/side-sessions.js.map +1 -1
- package/dist/tools/work-item-tools.d.ts.map +1 -1
- package/dist/tools/work-item-tools.js +12 -2
- package/dist/tools/work-item-tools.js.map +1 -1
- package/dist/work-item-branch.d.ts +1 -1
- package/dist/work-item-branch.d.ts.map +1 -1
- package/dist/work-item-branch.js +2 -0
- package/dist/work-item-branch.js.map +1 -1
- package/dist/work-items/board-filter-options.d.ts +5 -0
- package/dist/work-items/board-filter-options.d.ts.map +1 -0
- package/dist/work-items/board-filter-options.js +27 -0
- package/dist/work-items/board-filter-options.js.map +1 -0
- package/dist/work-items/board-phases.d.ts +28 -0
- package/dist/work-items/board-phases.d.ts.map +1 -0
- package/dist/work-items/board-phases.js +165 -0
- package/dist/work-items/board-phases.js.map +1 -0
- package/dist/work-items/card-facts.d.ts +24 -0
- package/dist/work-items/card-facts.d.ts.map +1 -0
- package/dist/work-items/card-facts.js +75 -0
- package/dist/work-items/card-facts.js.map +1 -0
- package/dist/work-items/card-labels.d.ts +5 -0
- package/dist/work-items/card-labels.d.ts.map +1 -0
- package/dist/work-items/card-labels.js +13 -0
- package/dist/work-items/card-labels.js.map +1 -0
- package/dist/work-items/card-number.d.ts +10 -0
- package/dist/work-items/card-number.d.ts.map +1 -0
- package/dist/work-items/card-number.js +15 -0
- package/dist/work-items/card-number.js.map +1 -0
- package/dist/work-items/card-people.d.ts +25 -0
- package/dist/work-items/card-people.d.ts.map +1 -0
- package/dist/work-items/card-people.js +100 -0
- package/dist/work-items/card-people.js.map +1 -0
- package/dist/work-items/card-search-text.d.ts +4 -0
- package/dist/work-items/card-search-text.d.ts.map +1 -0
- package/dist/work-items/card-search-text.js +15 -0
- package/dist/work-items/card-search-text.js.map +1 -0
- package/dist/work-items/card-source-filters.d.ts +23 -0
- package/dist/work-items/card-source-filters.d.ts.map +1 -0
- package/dist/work-items/card-source-filters.js +25 -0
- package/dist/work-items/card-source-filters.js.map +1 -0
- package/dist/work-items/create-work-item.d.ts +0 -6
- package/dist/work-items/create-work-item.d.ts.map +1 -1
- package/dist/work-items/create-work-item.js +2 -7
- package/dist/work-items/create-work-item.js.map +1 -1
- package/dist/work-items/list-related-cards.d.ts +4 -0
- package/dist/work-items/list-related-cards.d.ts.map +1 -0
- package/dist/work-items/list-related-cards.js +24 -0
- package/dist/work-items/list-related-cards.js.map +1 -0
- package/dist/work-items/search-words.d.ts +5 -0
- package/dist/work-items/search-words.d.ts.map +1 -0
- package/dist/work-items/search-words.js +12 -0
- package/dist/work-items/search-words.js.map +1 -0
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +92 -47
- package/dist/workspace.js.map +1 -1
- package/package.json +6 -5
|
@@ -12,12 +12,15 @@ import type { ProjectBoardCache } from '../boards/project-boards.js';
|
|
|
12
12
|
import type { AuditEmitter } from '../storage/domains/audit/domain.js';
|
|
13
13
|
import type { StoredBoardsStorage } from '../storage/domains/boards/base.js';
|
|
14
14
|
import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
|
|
15
|
+
import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
|
|
15
16
|
import type { RouteDependencies } from './route.js';
|
|
16
17
|
import { Route } from './route.js';
|
|
17
18
|
export interface IntakeRouteRoutesDeps extends RouteDependencies {
|
|
18
19
|
audit: AuditEmitter;
|
|
19
20
|
projects: FactoryProjectsStorage;
|
|
20
21
|
storage: StoredBoardsStorage;
|
|
22
|
+
/** Cards an intake route change may move to another board. */
|
|
23
|
+
workItems: Pick<WorkItemsStorage, 'listShared' | 'update' | 'supersedeDecisionsForWorkItem'>;
|
|
21
24
|
/** The project's installed boards, to check route targets against. */
|
|
22
25
|
boards: Pick<ProjectBoardCache, 'describe'>;
|
|
23
26
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"intake-routes.d.ts","sourceRoot":"","sources":["../../src/routes/intake-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAQpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;
|
|
1
|
+
{"version":3,"file":"intake-routes.d.ts","sourceRoot":"","sources":["../../src/routes/intake-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAQpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAAoB,mBAAmB,EAA2B,MAAM,mCAAmC,CAAC;AACxH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,8DAA8D;IAC9D,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,QAAQ,GAAG,+BAA+B,CAAC,CAAC;IAC7F,sEAAsE;IACtE,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;CAC7C;AAwBD,qBAAa,iBAAkB,SAAQ,KAAK,CAAC,qBAAqB,CAAC;;IAiIjE,MAAM,IAAI,QAAQ,EAAE,CA6FnB;CACF"}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { DEFAULT_ROUTE_EVENTS } from "../boards/board-events.js";
|
|
2
2
|
import { intakeTargetProblem } from "../boards/intake-routing.js";
|
|
3
|
+
import { applyReroute, planReroute, summarizeReroute } from "../boards/reroute.js";
|
|
3
4
|
import { StoredBoardError } from "../storage/domains/boards/base.js";
|
|
4
5
|
import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
|
|
5
6
|
import { Route, loose } from "./route.js";
|
|
@@ -91,6 +92,14 @@ var IntakeRouteRoutes = class extends Route {
|
|
|
91
92
|
message: problem.message
|
|
92
93
|
});
|
|
93
94
|
}
|
|
95
|
+
async #planReroute(scope) {
|
|
96
|
+
const [registry, routes, items] = await Promise.all([
|
|
97
|
+
this.#registry(scope),
|
|
98
|
+
this.deps.storage.listIntakeRoutes(scope),
|
|
99
|
+
this.deps.workItems.listShared(scope)
|
|
100
|
+
]);
|
|
101
|
+
return planReroute(routes, items, registry);
|
|
102
|
+
}
|
|
94
103
|
async #list(c, scope, routes) {
|
|
95
104
|
const registry = await this.#registry(scope);
|
|
96
105
|
routes ??= await this.deps.storage.listIntakeRoutes(scope);
|
|
@@ -142,6 +151,41 @@ var IntakeRouteRoutes = class extends Route {
|
|
|
142
151
|
const contracts = FACTORY_ROUTE_CONTRACTS;
|
|
143
152
|
return [
|
|
144
153
|
this.#route(contracts.intakeRouteList, async (c) => this.#list(c, await this.#resolve(c))),
|
|
154
|
+
this.#route(contracts.intakeRouteReroutePreview, async (c) => {
|
|
155
|
+
const scope = await this.#resolve(c);
|
|
156
|
+
const moves = await this.#planReroute(scope);
|
|
157
|
+
return c.json({
|
|
158
|
+
total: moves.length,
|
|
159
|
+
moves: summarizeReroute(moves)
|
|
160
|
+
});
|
|
161
|
+
}),
|
|
162
|
+
this.#route(contracts.intakeRouteRerouteApply, async (c) => {
|
|
163
|
+
const scope = await this.#resolve(c);
|
|
164
|
+
await this.#requireAdmin(c, scope);
|
|
165
|
+
const moves = await this.#planReroute(scope);
|
|
166
|
+
const result = await applyReroute({
|
|
167
|
+
moves,
|
|
168
|
+
workItems: this.deps.workItems,
|
|
169
|
+
registry: await this.#registry(scope),
|
|
170
|
+
userId: scope.userId
|
|
171
|
+
});
|
|
172
|
+
await this.deps.audit.emit({
|
|
173
|
+
context: c,
|
|
174
|
+
input: {
|
|
175
|
+
action: "factory.intake_route.rerouted",
|
|
176
|
+
factoryProjectId: scope.factoryProjectId,
|
|
177
|
+
targets: [...new Set(moves.map((move) => move.routeId))].map((id) => ({
|
|
178
|
+
type: "intake_route",
|
|
179
|
+
id
|
|
180
|
+
})),
|
|
181
|
+
metadata: {
|
|
182
|
+
...result,
|
|
183
|
+
moves: summarizeReroute(moves)
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
});
|
|
187
|
+
return c.json(result);
|
|
188
|
+
}),
|
|
145
189
|
this.#route(contracts.intakeRouteReorder, async (c) => {
|
|
146
190
|
const scope = await this.#resolve(c);
|
|
147
191
|
await this.#requireAdmin(c, scope);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"intake-routes.js","names":[],"sources":["../../src/routes/intake-routes.ts"],"sourcesContent":["/**\n * Mastra `apiRoutes` for managing a project's intake routes: the ordered rules that place new\n * cards on a board and phase when they arrive.\n *\n * Reads need a signed-in user of the project's organization; writes need an organization admin in\n * tenant mode. A route's target must be an installed board and a phase new cards can reach when it\n * is written; a target that\n * stops existing later is reported in `problems` and skipped when cards arrive.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\nimport type { z } from 'zod';\n\nimport { DEFAULT_ROUTE_EVENTS } from '../boards/board-events.js';\nimport type { StatusEvent } from '../boards/board-events.js';\nimport { intakeTargetProblem } from '../boards/intake-routing.js';\nimport type { ProjectBoardCache } from '../boards/project-boards.js';\nimport type { BoardRegistry } from '../boards/registry.js';\nimport type { AuditEmitter } from '../storage/domains/audit/domain.js';\nimport { StoredBoardError } from '../storage/domains/boards/base.js';\nimport type { StoredBoardScope, StoredBoardsStorage, StoredIntakeRouteRecord } from '../storage/domains/boards/base.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport { FACTORY_ROUTE_CONTRACTS } from './contracts.js';\nimport type { RouteDependencies } from './route.js';\nimport { loose, Route } from './route.js';\n\nexport interface IntakeRouteRoutesDeps extends RouteDependencies {\n audit: AuditEmitter;\n projects: FactoryProjectsStorage;\n storage: StoredBoardsStorage;\n /** The project's installed boards, to check route targets against. */\n boards: Pick<ProjectBoardCache, 'describe'>;\n}\n\ntype Resolved = StoredBoardScope & { userId: string };\n\n/** A response the handler returns as is: a refusal or an error. */\nclass Refusal {\n constructor(\n readonly status: 400 | 401 | 403 | 404 | 409 | 422,\n readonly body: Record<string, unknown>,\n ) {}\n}\n\nfunction issueMessage(issues: readonly z.core.$ZodIssue[]): string {\n return issues\n .map(issue => (issue.path.length > 0 ? `${issue.path.join('.')}: ${issue.message}` : issue.message))\n .join('; ');\n}\n\nfunction present(route: StoredIntakeRouteRecord, registry: BoardRegistry) {\n const { orgId: _orgId, factoryProjectId: _project, ...fields } = route;\n const problem = intakeTargetProblem(registry, route);\n return { ...fields, problems: problem ? [problem.message] : [] };\n}\n\nexport class IntakeRouteRoutes extends Route<IntakeRouteRoutesDeps> {\n async #resolve(c: Context): Promise<Resolved> {\n const { auth, projects } = this.deps;\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) throw new Refusal(401, { error: 'unauthorized' });\n if (!tenant.orgId) {\n throw new Refusal(403, { error: 'organization_required', message: 'Intake routes belong to an organization.' });\n }\n const parsed = FACTORY_ROUTE_CONTRACTS.intakeRouteList.pathSchema.safeParse({ id: c.req.param('id') });\n if (!parsed.success) throw new Refusal(404, { error: 'Project not found' });\n await projects.ensureReady();\n if (!(await projects.get({ orgId: tenant.orgId, id: parsed.data.id }))) {\n throw new Refusal(404, { error: 'Project not found' });\n }\n return { orgId: tenant.orgId, userId: tenant.userId, factoryProjectId: parsed.data.id };\n }\n\n async #requireAdmin(c: Context, scope: Resolved): Promise<void> {\n const { auth } = this.deps;\n if (auth.enabled() && !(await auth.isOrganizationAdmin(c, scope.orgId))) {\n throw new Refusal(403, {\n error: 'organization_admin_required',\n message: 'Organization administrator access is required to change intake routes.',\n });\n }\n }\n\n async #body<T>(c: Context, schema: z.ZodType<T>): Promise<T> {\n let body: unknown;\n try {\n body = await c.req.json();\n } catch {\n throw new Refusal(400, { error: 'invalid_request', message: 'Invalid JSON body.' });\n }\n const parsed = schema.safeParse(body);\n if (!parsed.success) {\n throw new Refusal(422, { error: 'invalid_intake_route', message: issueMessage(parsed.error.issues) });\n }\n return parsed.data;\n }\n\n #routeId(c: Context): string {\n const parsed = FACTORY_ROUTE_CONTRACTS.intakeRouteGet.pathSchema.safeParse({\n id: c.req.param('id'),\n routeId: c.req.param('routeId'),\n });\n if (!parsed.success) throw new Refusal(404, { error: 'intake_route_not_found' });\n return parsed.data.routeId;\n }\n\n async #registry(scope: Resolved): Promise<BoardRegistry> {\n return (await this.deps.boards.describe(scope)).registry;\n }\n\n /** Refuses a target that isn't an installed board and phase, or, for a route placing new cards, one they can't land in. */\n async #checkTarget(\n scope: Resolved,\n route: {\n target: { boardKey: string; phaseKey?: string | null; joinClosedIssue?: boolean };\n on: readonly StatusEvent[];\n },\n ) {\n const problem = intakeTargetProblem(await this.#registry(scope), route);\n if (problem) throw new Refusal(422, { error: problem.code, message: problem.message });\n }\n\n async #list(c: Context, scope: Resolved, routes?: StoredIntakeRouteRecord[]) {\n const registry = await this.#registry(scope);\n routes ??= await this.deps.storage.listIntakeRoutes(scope);\n const { auth } = this.deps;\n const canEdit = !auth.enabled() || (await auth.isOrganizationAdmin(c, scope.orgId));\n return c.json({ intakeRoutes: routes.map(route => present(route, registry)), canEdit });\n }\n\n async #respond(c: Context, scope: Resolved, route: StoredIntakeRouteRecord, status: 200 | 201 = 200) {\n return c.json({ intakeRoute: present(route, await this.#registry(scope)) }, status);\n }\n\n async #audit(\n c: Context,\n scope: Resolved,\n action: 'created' | 'updated' | 'deleted' | 'reordered',\n targets: { id: string; name: string }[],\n ) {\n await this.deps.audit.emit({\n context: c,\n input: {\n action: `factory.intake_route.${action}`,\n factoryProjectId: scope.factoryProjectId,\n targets: targets.map(route => ({ type: 'intake_route', id: route.id, name: route.name })),\n },\n });\n }\n\n #route(\n contract: { path: string; method: 'GET' | 'POST' | 'PATCH' | 'DELETE' },\n handle: (c: Context) => Promise<Response>,\n ): ApiRoute {\n return registerApiRoute(contract.path, {\n method: contract.method,\n requiresAuth: false,\n handler: async c => {\n const context = loose(c);\n try {\n return await handle(context);\n } catch (error) {\n if (error instanceof Refusal) return context.json(error.body, error.status);\n if (error instanceof StoredBoardError) {\n return context.json(\n { error: error.code, message: error.message },\n error.code === 'intake_route_not_found' ? 404 : error.code === 'invalid_intake_route' ? 422 : 409,\n );\n }\n throw error;\n }\n },\n });\n }\n\n routes(): ApiRoute[] {\n const { storage } = this.deps;\n const contracts = FACTORY_ROUTE_CONTRACTS;\n return [\n this.#route(contracts.intakeRouteList, async c => this.#list(c, await this.#resolve(c))),\n\n this.#route(contracts.intakeRouteReorder, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const { ids } = await this.#body(c, contracts.intakeRouteReorder.bodySchema);\n const routes = await storage.reorderIntakeRoutes(scope, ids, scope.userId);\n await this.#audit(c, scope, 'reordered', routes);\n return this.#list(c, scope, routes);\n }),\n\n this.#route(contracts.intakeRouteGet, async c => {\n const scope = await this.#resolve(c);\n const route = await storage.getIntakeRoute(scope, this.#routeId(c));\n if (!route) throw new Refusal(404, { error: 'intake_route_not_found' });\n return this.#respond(c, scope, route);\n }),\n\n this.#route(contracts.intakeRouteCreate, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const input = await this.#body(c, contracts.intakeRouteCreate.bodySchema);\n await this.#checkTarget(scope, { target: input.target, on: input.on ?? DEFAULT_ROUTE_EVENTS });\n const route = await storage.createIntakeRoute(scope, input, scope.userId);\n await this.#audit(c, scope, 'created', [route]);\n return this.#respond(c, scope, route, 201);\n }),\n\n this.#route(contracts.intakeRouteUpdate, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const id = this.#routeId(c);\n const { expectedRevision, ...patch } = await this.#body(c, contracts.intakeRouteUpdate.bodySchema);\n if (patch.target || patch.on) {\n // Narrowing or widening `on` changes which targets are allowed, so check the route as it will be.\n const current = await storage.getIntakeRoute(scope, id);\n if (!current) throw new Refusal(404, { error: 'intake_route_not_found' });\n await this.#checkTarget(scope, { target: patch.target ?? current.target, on: patch.on ?? current.on });\n }\n const route = await storage.updateIntakeRoute(scope, id, patch, { expectedRevision, actor: scope.userId });\n await this.#audit(c, scope, 'updated', [route]);\n return this.#respond(c, scope, route);\n }),\n\n this.#route(contracts.intakeRouteDelete, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const id = this.#routeId(c);\n const parsed = contracts.intakeRouteDelete.querySchema.safeParse({\n expectedRevision: c.req.query('expectedRevision'),\n });\n if (!parsed.success) {\n throw new Refusal(422, { error: 'invalid_request', message: issueMessage(parsed.error.issues) });\n }\n const route = await storage.getIntakeRoute(scope, id);\n if (!route) throw new Refusal(404, { error: 'intake_route_not_found' });\n await storage.deleteIntakeRoute(scope, id, { expectedRevision: parsed.data.expectedRevision });\n await this.#audit(c, scope, 'deleted', [route]);\n return c.body(null, 204);\n }),\n ];\n }\n}\n"],"mappings":";;;;;;;;AAuCA,IAAM,UAAN,MAAc;CAED;CACA;CAFX,YACE,QACA,MACA;EAFS,KAAA,SAAA;EACA,KAAA,OAAA;CACR;AACL;AAEA,SAAS,aAAa,QAA6C;CACjE,OAAO,OACJ,KAAI,UAAU,MAAM,KAAK,SAAS,IAAI,GAAG,MAAM,KAAK,KAAK,GAAG,EAAE,IAAI,MAAM,YAAY,MAAM,OAAQ,CAAC,CACnG,KAAK,IAAI;AACd;AAEA,SAAS,QAAQ,OAAgC,UAAyB;CACxE,MAAM,EAAE,OAAO,QAAQ,kBAAkB,UAAU,GAAG,WAAW;CACjE,MAAM,UAAU,oBAAoB,UAAU,KAAK;CACnD,OAAO;EAAE,GAAG;EAAQ,UAAU,UAAU,CAAC,QAAQ,OAAO,IAAI,CAAC;CAAE;AACjE;AAEA,IAAa,oBAAb,cAAuC,MAA6B;CAClE,MAAM,SAAS,GAA+B;EAC5C,MAAM,EAAE,MAAM,aAAa,KAAK;EAChC,MAAM,KAAK,WAAW,CAAC;EACvB,MAAM,SAAS,KAAK,OAAO,CAAC;EAC5B,IAAI,CAAC,QAAQ,MAAM,IAAI,QAAQ,KAAK,EAAE,OAAO,eAAe,CAAC;EAC7D,IAAI,CAAC,OAAO,OACV,MAAM,IAAI,QAAQ,KAAK;GAAE,OAAO;GAAyB,SAAS;EAA2C,CAAC;EAEhH,MAAM,SAAS,wBAAwB,gBAAgB,WAAW,UAAU,EAAE,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE,CAAC;EACrG,IAAI,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,KAAK,EAAE,OAAO,oBAAoB,CAAC;EAC1E,MAAM,SAAS,YAAY;EAC3B,IAAI,CAAE,MAAM,SAAS,IAAI;GAAE,OAAO,OAAO;GAAO,IAAI,OAAO,KAAK;EAAG,CAAC,GAClE,MAAM,IAAI,QAAQ,KAAK,EAAE,OAAO,oBAAoB,CAAC;EAEvD,OAAO;GAAE,OAAO,OAAO;GAAO,QAAQ,OAAO;GAAQ,kBAAkB,OAAO,KAAK;EAAG;CACxF;CAEA,MAAM,cAAc,GAAY,OAAgC;EAC9D,MAAM,EAAE,SAAS,KAAK;EACtB,IAAI,KAAK,QAAQ,KAAK,CAAE,MAAM,KAAK,oBAAoB,GAAG,MAAM,KAAK,GACnE,MAAM,IAAI,QAAQ,KAAK;GACrB,OAAO;GACP,SAAS;EACX,CAAC;CAEL;CAEA,MAAM,MAAS,GAAY,QAAkC;EAC3D,IAAI;EACJ,IAAI;GACF,OAAO,MAAM,EAAE,IAAI,KAAK;EAC1B,QAAQ;GACN,MAAM,IAAI,QAAQ,KAAK;IAAE,OAAO;IAAmB,SAAS;GAAqB,CAAC;EACpF;EACA,MAAM,SAAS,OAAO,UAAU,IAAI;EACpC,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,QAAQ,KAAK;GAAE,OAAO;GAAwB,SAAS,aAAa,OAAO,MAAM,MAAM;EAAE,CAAC;EAEtG,OAAO,OAAO;CAChB;CAEA,SAAS,GAAoB;EAC3B,MAAM,SAAS,wBAAwB,eAAe,WAAW,UAAU;GACzE,IAAI,EAAE,IAAI,MAAM,IAAI;GACpB,SAAS,EAAE,IAAI,MAAM,SAAS;EAChC,CAAC;EACD,IAAI,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,KAAK,EAAE,OAAO,yBAAyB,CAAC;EAC/E,OAAO,OAAO,KAAK;CACrB;CAEA,MAAM,UAAU,OAAyC;EACvD,QAAQ,MAAM,KAAK,KAAK,OAAO,SAAS,KAAK,EAAA,CAAG;CAClD;;CAGA,MAAM,aACJ,OACA,OAIA;EACA,MAAM,UAAU,oBAAoB,MAAM,KAAK,UAAU,KAAK,GAAG,KAAK;EACtE,IAAI,SAAS,MAAM,IAAI,QAAQ,KAAK;GAAE,OAAO,QAAQ;GAAM,SAAS,QAAQ;EAAQ,CAAC;CACvF;CAEA,MAAM,MAAM,GAAY,OAAiB,QAAoC;EAC3E,MAAM,WAAW,MAAM,KAAK,UAAU,KAAK;EAC3C,WAAW,MAAM,KAAK,KAAK,QAAQ,iBAAiB,KAAK;EACzD,MAAM,EAAE,SAAS,KAAK;EACtB,MAAM,UAAU,CAAC,KAAK,QAAQ,KAAM,MAAM,KAAK,oBAAoB,GAAG,MAAM,KAAK;EACjF,OAAO,EAAE,KAAK;GAAE,cAAc,OAAO,KAAI,UAAS,QAAQ,OAAO,QAAQ,CAAC;GAAG;EAAQ,CAAC;CACxF;CAEA,MAAM,SAAS,GAAY,OAAiB,OAAgC,SAAoB,KAAK;EACnG,OAAO,EAAE,KAAK,EAAE,aAAa,QAAQ,OAAO,MAAM,KAAK,UAAU,KAAK,CAAC,EAAE,GAAG,MAAM;CACpF;CAEA,MAAM,OACJ,GACA,OACA,QACA,SACA;EACA,MAAM,KAAK,KAAK,MAAM,KAAK;GACzB,SAAS;GACT,OAAO;IACL,QAAQ,wBAAwB;IAChC,kBAAkB,MAAM;IACxB,SAAS,QAAQ,KAAI,WAAU;KAAE,MAAM;KAAgB,IAAI,MAAM;KAAI,MAAM,MAAM;IAAK,EAAE;GAC1F;EACF,CAAC;CACH;CAEA,OACE,UACA,QACU;EACV,OAAO,iBAAiB,SAAS,MAAM;GACrC,QAAQ,SAAS;GACjB,cAAc;GACd,SAAS,OAAM,MAAK;IAClB,MAAM,UAAU,MAAM,CAAC;IACvB,IAAI;KACF,OAAO,MAAM,OAAO,OAAO;IAC7B,SAAS,OAAO;KACd,IAAI,iBAAiB,SAAS,OAAO,QAAQ,KAAK,MAAM,MAAM,MAAM,MAAM;KAC1E,IAAI,iBAAiB,kBACnB,OAAO,QAAQ,KACb;MAAE,OAAO,MAAM;MAAM,SAAS,MAAM;KAAQ,GAC5C,MAAM,SAAS,2BAA2B,MAAM,MAAM,SAAS,yBAAyB,MAAM,GAChG;KAEF,MAAM;IACR;GACF;EACF,CAAC;CACH;CAEA,SAAqB;EACnB,MAAM,EAAE,YAAY,KAAK;EACzB,MAAM,YAAY;EAClB,OAAO;GACL,KAAK,OAAO,UAAU,iBAAiB,OAAM,MAAK,KAAK,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC;GAEvF,KAAK,OAAO,UAAU,oBAAoB,OAAM,MAAK;IACnD,MAAM,QAAQ,MAAM,KAAK,SAAS,CAAC;IACnC,MAAM,KAAK,cAAc,GAAG,KAAK;IACjC,MAAM,EAAE,QAAQ,MAAM,KAAK,MAAM,GAAG,UAAU,mBAAmB,UAAU;IAC3E,MAAM,SAAS,MAAM,QAAQ,oBAAoB,OAAO,KAAK,MAAM,MAAM;IACzE,MAAM,KAAK,OAAO,GAAG,OAAO,aAAa,MAAM;IAC/C,OAAO,KAAK,MAAM,GAAG,OAAO,MAAM;GACpC,CAAC;GAED,KAAK,OAAO,UAAU,gBAAgB,OAAM,MAAK;IAC/C,MAAM,QAAQ,MAAM,KAAK,SAAS,CAAC;IACnC,MAAM,QAAQ,MAAM,QAAQ,eAAe,OAAO,KAAK,SAAS,CAAC,CAAC;IAClE,IAAI,CAAC,OAAO,MAAM,IAAI,QAAQ,KAAK,EAAE,OAAO,yBAAyB,CAAC;IACtE,OAAO,KAAK,SAAS,GAAG,OAAO,KAAK;GACtC,CAAC;GAED,KAAK,OAAO,UAAU,mBAAmB,OAAM,MAAK;IAClD,MAAM,QAAQ,MAAM,KAAK,SAAS,CAAC;IACnC,MAAM,KAAK,cAAc,GAAG,KAAK;IACjC,MAAM,QAAQ,MAAM,KAAK,MAAM,GAAG,UAAU,kBAAkB,UAAU;IACxE,MAAM,KAAK,aAAa,OAAO;KAAE,QAAQ,MAAM;KAAQ,IAAI,MAAM,MAAM;IAAqB,CAAC;IAC7F,MAAM,QAAQ,MAAM,QAAQ,kBAAkB,OAAO,OAAO,MAAM,MAAM;IACxE,MAAM,KAAK,OAAO,GAAG,OAAO,WAAW,CAAC,KAAK,CAAC;IAC9C,OAAO,KAAK,SAAS,GAAG,OAAO,OAAO,GAAG;GAC3C,CAAC;GAED,KAAK,OAAO,UAAU,mBAAmB,OAAM,MAAK;IAClD,MAAM,QAAQ,MAAM,KAAK,SAAS,CAAC;IACnC,MAAM,KAAK,cAAc,GAAG,KAAK;IACjC,MAAM,KAAK,KAAK,SAAS,CAAC;IAC1B,MAAM,EAAE,kBAAkB,GAAG,UAAU,MAAM,KAAK,MAAM,GAAG,UAAU,kBAAkB,UAAU;IACjG,IAAI,MAAM,UAAU,MAAM,IAAI;KAE5B,MAAM,UAAU,MAAM,QAAQ,eAAe,OAAO,EAAE;KACtD,IAAI,CAAC,SAAS,MAAM,IAAI,QAAQ,KAAK,EAAE,OAAO,yBAAyB,CAAC;KACxE,MAAM,KAAK,aAAa,OAAO;MAAE,QAAQ,MAAM,UAAU,QAAQ;MAAQ,IAAI,MAAM,MAAM,QAAQ;KAAG,CAAC;IACvG;IACA,MAAM,QAAQ,MAAM,QAAQ,kBAAkB,OAAO,IAAI,OAAO;KAAE;KAAkB,OAAO,MAAM;IAAO,CAAC;IACzG,MAAM,KAAK,OAAO,GAAG,OAAO,WAAW,CAAC,KAAK,CAAC;IAC9C,OAAO,KAAK,SAAS,GAAG,OAAO,KAAK;GACtC,CAAC;GAED,KAAK,OAAO,UAAU,mBAAmB,OAAM,MAAK;IAClD,MAAM,QAAQ,MAAM,KAAK,SAAS,CAAC;IACnC,MAAM,KAAK,cAAc,GAAG,KAAK;IACjC,MAAM,KAAK,KAAK,SAAS,CAAC;IAC1B,MAAM,SAAS,UAAU,kBAAkB,YAAY,UAAU,EAC/D,kBAAkB,EAAE,IAAI,MAAM,kBAAkB,EAClD,CAAC;IACD,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,QAAQ,KAAK;KAAE,OAAO;KAAmB,SAAS,aAAa,OAAO,MAAM,MAAM;IAAE,CAAC;IAEjG,MAAM,QAAQ,MAAM,QAAQ,eAAe,OAAO,EAAE;IACpD,IAAI,CAAC,OAAO,MAAM,IAAI,QAAQ,KAAK,EAAE,OAAO,yBAAyB,CAAC;IACtE,MAAM,QAAQ,kBAAkB,OAAO,IAAI,EAAE,kBAAkB,OAAO,KAAK,iBAAiB,CAAC;IAC7F,MAAM,KAAK,OAAO,GAAG,OAAO,WAAW,CAAC,KAAK,CAAC;IAC9C,OAAO,EAAE,KAAK,MAAM,GAAG;GACzB,CAAC;EACH;CACF;AACF"}
|
|
1
|
+
{"version":3,"file":"intake-routes.js","names":[],"sources":["../../src/routes/intake-routes.ts"],"sourcesContent":["/**\n * Mastra `apiRoutes` for managing a project's intake routes: the ordered rules that place new\n * cards on a board and phase when they arrive.\n *\n * Reads need a signed-in user of the project's organization; writes need an organization admin in\n * tenant mode. A route's target must be an installed board and a phase new cards can reach when it\n * is written; a target that\n * stops existing later is reported in `problems` and skipped when cards arrive.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\nimport type { z } from 'zod';\n\nimport { DEFAULT_ROUTE_EVENTS } from '../boards/board-events.js';\nimport type { StatusEvent } from '../boards/board-events.js';\nimport { intakeTargetProblem } from '../boards/intake-routing.js';\nimport type { ProjectBoardCache } from '../boards/project-boards.js';\nimport type { BoardRegistry } from '../boards/registry.js';\nimport { applyReroute, planReroute, summarizeReroute } from '../boards/reroute.js';\nimport type { AuditEmitter } from '../storage/domains/audit/domain.js';\nimport { StoredBoardError } from '../storage/domains/boards/base.js';\nimport type { StoredBoardScope, StoredBoardsStorage, StoredIntakeRouteRecord } from '../storage/domains/boards/base.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { FACTORY_ROUTE_CONTRACTS } from './contracts.js';\nimport type { RouteDependencies } from './route.js';\nimport { loose, Route } from './route.js';\n\nexport interface IntakeRouteRoutesDeps extends RouteDependencies {\n audit: AuditEmitter;\n projects: FactoryProjectsStorage;\n storage: StoredBoardsStorage;\n /** Cards an intake route change may move to another board. */\n workItems: Pick<WorkItemsStorage, 'listShared' | 'update' | 'supersedeDecisionsForWorkItem'>;\n /** The project's installed boards, to check route targets against. */\n boards: Pick<ProjectBoardCache, 'describe'>;\n}\n\ntype Resolved = StoredBoardScope & { userId: string };\n\n/** A response the handler returns as is: a refusal or an error. */\nclass Refusal {\n constructor(\n readonly status: 400 | 401 | 403 | 404 | 409 | 422,\n readonly body: Record<string, unknown>,\n ) {}\n}\n\nfunction issueMessage(issues: readonly z.core.$ZodIssue[]): string {\n return issues\n .map(issue => (issue.path.length > 0 ? `${issue.path.join('.')}: ${issue.message}` : issue.message))\n .join('; ');\n}\n\nfunction present(route: StoredIntakeRouteRecord, registry: BoardRegistry) {\n const { orgId: _orgId, factoryProjectId: _project, ...fields } = route;\n const problem = intakeTargetProblem(registry, route);\n return { ...fields, problems: problem ? [problem.message] : [] };\n}\n\nexport class IntakeRouteRoutes extends Route<IntakeRouteRoutesDeps> {\n async #resolve(c: Context): Promise<Resolved> {\n const { auth, projects } = this.deps;\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) throw new Refusal(401, { error: 'unauthorized' });\n if (!tenant.orgId) {\n throw new Refusal(403, { error: 'organization_required', message: 'Intake routes belong to an organization.' });\n }\n const parsed = FACTORY_ROUTE_CONTRACTS.intakeRouteList.pathSchema.safeParse({ id: c.req.param('id') });\n if (!parsed.success) throw new Refusal(404, { error: 'Project not found' });\n await projects.ensureReady();\n if (!(await projects.get({ orgId: tenant.orgId, id: parsed.data.id }))) {\n throw new Refusal(404, { error: 'Project not found' });\n }\n return { orgId: tenant.orgId, userId: tenant.userId, factoryProjectId: parsed.data.id };\n }\n\n async #requireAdmin(c: Context, scope: Resolved): Promise<void> {\n const { auth } = this.deps;\n if (auth.enabled() && !(await auth.isOrganizationAdmin(c, scope.orgId))) {\n throw new Refusal(403, {\n error: 'organization_admin_required',\n message: 'Organization administrator access is required to change intake routes.',\n });\n }\n }\n\n async #body<T>(c: Context, schema: z.ZodType<T>): Promise<T> {\n let body: unknown;\n try {\n body = await c.req.json();\n } catch {\n throw new Refusal(400, { error: 'invalid_request', message: 'Invalid JSON body.' });\n }\n const parsed = schema.safeParse(body);\n if (!parsed.success) {\n throw new Refusal(422, { error: 'invalid_intake_route', message: issueMessage(parsed.error.issues) });\n }\n return parsed.data;\n }\n\n #routeId(c: Context): string {\n const parsed = FACTORY_ROUTE_CONTRACTS.intakeRouteGet.pathSchema.safeParse({\n id: c.req.param('id'),\n routeId: c.req.param('routeId'),\n });\n if (!parsed.success) throw new Refusal(404, { error: 'intake_route_not_found' });\n return parsed.data.routeId;\n }\n\n async #registry(scope: Resolved): Promise<BoardRegistry> {\n return (await this.deps.boards.describe(scope)).registry;\n }\n\n /** Refuses a target that isn't an installed board and phase, or, for a route placing new cards, one they can't land in. */\n async #checkTarget(\n scope: Resolved,\n route: {\n target: { boardKey: string; phaseKey?: string | null; joinClosedIssue?: boolean };\n on: readonly StatusEvent[];\n },\n ) {\n const problem = intakeTargetProblem(await this.#registry(scope), route);\n if (problem) throw new Refusal(422, { error: problem.code, message: problem.message });\n }\n\n async #planReroute(scope: Resolved) {\n const [registry, routes, items] = await Promise.all([\n this.#registry(scope),\n this.deps.storage.listIntakeRoutes(scope),\n this.deps.workItems.listShared(scope),\n ]);\n return planReroute(routes, items, registry);\n }\n\n async #list(c: Context, scope: Resolved, routes?: StoredIntakeRouteRecord[]) {\n const registry = await this.#registry(scope);\n routes ??= await this.deps.storage.listIntakeRoutes(scope);\n const { auth } = this.deps;\n const canEdit = !auth.enabled() || (await auth.isOrganizationAdmin(c, scope.orgId));\n return c.json({ intakeRoutes: routes.map(route => present(route, registry)), canEdit });\n }\n\n async #respond(c: Context, scope: Resolved, route: StoredIntakeRouteRecord, status: 200 | 201 = 200) {\n return c.json({ intakeRoute: present(route, await this.#registry(scope)) }, status);\n }\n\n async #audit(\n c: Context,\n scope: Resolved,\n action: 'created' | 'updated' | 'deleted' | 'reordered',\n targets: { id: string; name: string }[],\n ) {\n await this.deps.audit.emit({\n context: c,\n input: {\n action: `factory.intake_route.${action}`,\n factoryProjectId: scope.factoryProjectId,\n targets: targets.map(route => ({ type: 'intake_route', id: route.id, name: route.name })),\n },\n });\n }\n\n #route(\n contract: { path: string; method: 'GET' | 'POST' | 'PATCH' | 'DELETE' },\n handle: (c: Context) => Promise<Response>,\n ): ApiRoute {\n return registerApiRoute(contract.path, {\n method: contract.method,\n requiresAuth: false,\n handler: async c => {\n const context = loose(c);\n try {\n return await handle(context);\n } catch (error) {\n if (error instanceof Refusal) return context.json(error.body, error.status);\n if (error instanceof StoredBoardError) {\n return context.json(\n { error: error.code, message: error.message },\n error.code === 'intake_route_not_found' ? 404 : error.code === 'invalid_intake_route' ? 422 : 409,\n );\n }\n throw error;\n }\n },\n });\n }\n\n routes(): ApiRoute[] {\n const { storage } = this.deps;\n const contracts = FACTORY_ROUTE_CONTRACTS;\n return [\n this.#route(contracts.intakeRouteList, async c => this.#list(c, await this.#resolve(c))),\n\n this.#route(contracts.intakeRouteReroutePreview, async c => {\n const scope = await this.#resolve(c);\n const moves = await this.#planReroute(scope);\n return c.json({ total: moves.length, moves: summarizeReroute(moves) });\n }),\n\n this.#route(contracts.intakeRouteRerouteApply, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const moves = await this.#planReroute(scope);\n const result = await applyReroute({\n moves,\n workItems: this.deps.workItems,\n registry: await this.#registry(scope),\n userId: scope.userId,\n });\n await this.deps.audit.emit({\n context: c,\n input: {\n action: 'factory.intake_route.rerouted',\n factoryProjectId: scope.factoryProjectId,\n targets: [...new Set(moves.map(move => move.routeId))].map(id => ({ type: 'intake_route', id })),\n metadata: { ...result, moves: summarizeReroute(moves) },\n },\n });\n return c.json(result);\n }),\n\n this.#route(contracts.intakeRouteReorder, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const { ids } = await this.#body(c, contracts.intakeRouteReorder.bodySchema);\n const routes = await storage.reorderIntakeRoutes(scope, ids, scope.userId);\n await this.#audit(c, scope, 'reordered', routes);\n return this.#list(c, scope, routes);\n }),\n\n this.#route(contracts.intakeRouteGet, async c => {\n const scope = await this.#resolve(c);\n const route = await storage.getIntakeRoute(scope, this.#routeId(c));\n if (!route) throw new Refusal(404, { error: 'intake_route_not_found' });\n return this.#respond(c, scope, route);\n }),\n\n this.#route(contracts.intakeRouteCreate, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const input = await this.#body(c, contracts.intakeRouteCreate.bodySchema);\n await this.#checkTarget(scope, { target: input.target, on: input.on ?? DEFAULT_ROUTE_EVENTS });\n const route = await storage.createIntakeRoute(scope, input, scope.userId);\n await this.#audit(c, scope, 'created', [route]);\n return this.#respond(c, scope, route, 201);\n }),\n\n this.#route(contracts.intakeRouteUpdate, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const id = this.#routeId(c);\n const { expectedRevision, ...patch } = await this.#body(c, contracts.intakeRouteUpdate.bodySchema);\n if (patch.target || patch.on) {\n // Narrowing or widening `on` changes which targets are allowed, so check the route as it will be.\n const current = await storage.getIntakeRoute(scope, id);\n if (!current) throw new Refusal(404, { error: 'intake_route_not_found' });\n await this.#checkTarget(scope, { target: patch.target ?? current.target, on: patch.on ?? current.on });\n }\n const route = await storage.updateIntakeRoute(scope, id, patch, { expectedRevision, actor: scope.userId });\n await this.#audit(c, scope, 'updated', [route]);\n return this.#respond(c, scope, route);\n }),\n\n this.#route(contracts.intakeRouteDelete, async c => {\n const scope = await this.#resolve(c);\n await this.#requireAdmin(c, scope);\n const id = this.#routeId(c);\n const parsed = contracts.intakeRouteDelete.querySchema.safeParse({\n expectedRevision: c.req.query('expectedRevision'),\n });\n if (!parsed.success) {\n throw new Refusal(422, { error: 'invalid_request', message: issueMessage(parsed.error.issues) });\n }\n const route = await storage.getIntakeRoute(scope, id);\n if (!route) throw new Refusal(404, { error: 'intake_route_not_found' });\n await storage.deleteIntakeRoute(scope, id, { expectedRevision: parsed.data.expectedRevision });\n await this.#audit(c, scope, 'deleted', [route]);\n return c.body(null, 204);\n }),\n ];\n }\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/routes/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwB,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/routes/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwB,MAAM,wBAAwB,CAAC;AAW9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAgB1C,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,6FAA6F;IAC7F,QAAQ,EAAE,sBAAsB,CAAC;IACjC,uFAAuF;IACvF,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC3D,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAyDD,qBAAa,eAAgB,SAAQ,KAAK,CAAC,mBAAmB,CAAC;;IAmD7D,MAAM,IAAI,QAAQ,EAAE,CA2KnB;CACF"}
|
package/dist/routes/knowledge.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Route, loose } from "./route.js";
|
|
2
2
|
import { registerApiRoute } from "@mastra/core/server";
|
|
3
3
|
import { streamSSE } from "hono/streaming";
|
|
4
|
-
import { KnowledgeDeclarationError, listKnowledgeTreeChildren, readKnowledgePage, readKnowledgePageActivity, readKnowledgePageGraph, readKnowledgeScopeGrants, searchKnowledgeExplorerPages } from "@mastra/core/knowledge";
|
|
4
|
+
import { KnowledgeDeclarationError, encodeKnowledgeScopeId, listKnowledgeTreeChildren, readKnowledgePage, readKnowledgePageActivity, readKnowledgePageGraph, readKnowledgeScopeGrants, searchKnowledgeExplorerPages } from "@mastra/core/knowledge";
|
|
5
5
|
// src/routes/knowledge.ts
|
|
6
6
|
const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
7
7
|
/** Ids and cursors are opaque, but bounded so an unbounded query string never reaches storage. */
|
|
@@ -94,10 +94,11 @@ var KnowledgeRoutes = class extends Route {
|
|
|
94
94
|
message: "The configured Knowledge runtime is unavailable."
|
|
95
95
|
}, 503) };
|
|
96
96
|
try {
|
|
97
|
+
const principals = [`org:${encodeKnowledgeScopeId(tenant.orgId)}`, `project:${encodeKnowledgeScopeId(projectId)}`];
|
|
97
98
|
return {
|
|
98
99
|
knowledge,
|
|
99
100
|
store,
|
|
100
|
-
read: await knowledge.readScopeFor(
|
|
101
|
+
read: await knowledge.readScopeFor(principals)
|
|
101
102
|
};
|
|
102
103
|
} catch (error) {
|
|
103
104
|
if (error instanceof KnowledgeDeclarationError) return { response: c.json({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"knowledge.js","names":[],"sources":["../../src/routes/knowledge.ts"],"sourcesContent":["/**\n * Read-only Mastra `apiRoutes` behind Factory's Knowledge page: the schema-4 page tree, a page with its\n * notes, the bounded page graph, search and activity, all through the same core page readers Studio uses,\n * plus a change stream (`/events`, SSE) naming the pages and scopes each committed write touched.\n * Every endpoint is a GET; this module never writes Knowledge.\n *\n * Scoping is fail-closed and server-side. The caller must be signed in to an org that owns the `:id`\n * project, and reads are limited to what the Knowledge's own declarations give the principals\n * `org:<orgId>` and `project:<projectId>`: the scopes a run in that project holds at org and project\n * level. Session (`resource:`/`thread:`) scopes are not principals here, so no member browses another\n * member's session pages. The host must declare `project:$projectId` (as its session runs need); without\n * it reads fail with 500 `knowledge_misconfigured`.\n */\n\nimport type { Knowledge, KnowledgeChangeEvent } from '@mastra/core/knowledge';\nimport {\n KnowledgeDeclarationError,\n listKnowledgeTreeChildren,\n readKnowledgePage,\n readKnowledgePageActivity,\n readKnowledgePageGraph,\n readKnowledgeScopeGrants,\n searchKnowledgeExplorerPages,\n} from '@mastra/core/knowledge';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { KnowledgeReadScope, KnowledgeStorage } from '@mastra/core/storage';\nimport type { Context } from 'hono';\nimport { streamSSE } from 'hono/streaming';\n\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { RouteDependencies } from './route.js';\nimport { loose, Route } from './route.js';\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n/** Ids and cursors are opaque, but bounded so an unbounded query string never reaches storage. */\nconst ID_LIMIT = 256;\nconst SEARCH_QUERY_LIMIT = 128;\nconst MAX_PAGE_LIMIT = 100;\nconst MAX_GRAPH_PAGES = 500;\n/** Comment frames only: proxies drop an idle stream. */\nconst EVENTS_KEEPALIVE_MS = 25_000;\n/**\n * The read scope is resolved when the stream opens. Closing it after this long makes the browser reconnect,\n * which re-checks membership and the read scope, so a revoked member stops hearing about changes.\n */\nconst EVENTS_MAX_AGE_MS = 5 * 60_000;\n\nexport interface KnowledgeRoutesDeps extends RouteDependencies {\n /** Factory projects domain: validates that the `:id` project belongs to the caller's org. */\n projects: FactoryProjectsStorage;\n /** Lazy handle to the host-registered Knowledge runtime; endpoints 503 when absent. */\n knowledge: (key: string) => Promise<Knowledge | undefined>;\n /** Host-selected Knowledge key. Requests cannot override it. */\n defaultKnowledgeKey?: string;\n}\n\ninterface ResolvedView {\n knowledge: Knowledge;\n store: KnowledgeStorage;\n read: KnowledgeReadScope;\n}\n\nfunction boundedId(value: string | undefined): string | undefined {\n if (value === undefined) return undefined;\n const trimmed = value.trim();\n return trimmed && trimmed.length <= ID_LIMIT ? trimmed : undefined;\n}\n\nfunction boundedLimit(value: string | undefined, max: number): number | undefined | null {\n if (value === undefined) return undefined;\n const parsed = Number(value);\n return Number.isInteger(parsed) && parsed >= 1 && parsed <= max ? parsed : null;\n}\n\n/**\n * The ids of a change this caller may see, or null when they may see none of it. Events carry ids only, so\n * readability is checked against the store now: a page moved out of reach is withheld, but the scope it\n * left still tells the caller to refresh.\n */\nasync function visibleChange(store: KnowledgeStorage, read: KnowledgeReadScope, event: KnowledgeChangeEvent) {\n const readable = async (id: string | undefined) =>\n id !== undefined && (read === 'all' || (await store.getPage({ id, read })) !== null);\n const scopeId = 'scopeId' in event ? event.scopeId : undefined;\n const fromScopeId = 'fromScopeId' in event ? event.fromScopeId : undefined;\n const [page, scope, fromScope] = await Promise.all([\n readable(event.pageId),\n readable(scopeId),\n readable(fromScopeId),\n ]);\n if (!page && !scope && !fromScope) return null;\n return {\n kind: event.kind,\n op: event.op,\n ...(page ? { pageId: event.pageId } : {}),\n ...(scope ? { scopeId } : {}),\n at: event.at.toISOString(),\n };\n}\n\ntype LabelablePage = { isScope: boolean; address?: string };\n\n/**\n * Adds a scope page's declared `displayLabel` with the address's `$params` filled in (`'$orgId policy'`\n * → `'acme policy'`); declarations live in config, not storage.\n */\nfunction withDisplayLabel<T extends LabelablePage>(knowledge: Knowledge, page: T): T & { displayLabel?: string } {\n if (!page.isScope || !page.address) return page;\n const displayLabel = knowledge.scopeLabel(page.address);\n return displayLabel ? { ...page, displayLabel } : page;\n}\n\nexport class KnowledgeRoutes extends Route<KnowledgeRoutesDeps> {\n /** Tenant, org-owned project, Knowledge runtime and the caller's read scope: the one seam every route shares. */\n async #resolveView(c: Context): Promise<ResolvedView | { response: Response }> {\n await this.deps.auth.ensureUser(c);\n const tenant = this.deps.auth.tenant(c);\n if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n if (!tenant.orgId) {\n return {\n response: c.json({ error: 'organization_required', message: 'Knowledge requires an organization.' }, 403),\n };\n }\n\n const projectId = c.req.param('id');\n if (!projectId || !UUID_RE.test(projectId)) return { response: c.json({ error: 'Project not found' }, 404) };\n await this.deps.projects.ensureReady();\n const project = await this.deps.projects.get({ orgId: tenant.orgId, id: projectId });\n if (!project) return { response: c.json({ error: 'Project not found' }, 404) };\n\n let knowledge: Knowledge | undefined;\n let store: KnowledgeStorage | undefined;\n try {\n knowledge = await this.deps.knowledge(this.deps.defaultKnowledgeKey ?? 'default');\n store = knowledge ? await knowledge.getStorage() : undefined;\n } catch {\n store = undefined;\n }\n if (!knowledge || !store) {\n return {\n response: c.json(\n { error: 'knowledge_unavailable', message: 'The configured Knowledge runtime is unavailable.' },\n 503,\n ),\n };\n }\n try {\n return { knowledge, store, read: await knowledge.readScopeFor([`org:${tenant.orgId}`, `project:${projectId}`]) };\n } catch (error) {\n // The host's Knowledge does not declare the scopes a Factory run holds (`org:` and `project:`): a\n // deployment misconfiguration, which its session runs hit too. Never fall back to a guessed scope.\n if (error instanceof KnowledgeDeclarationError) {\n return { response: c.json({ error: 'knowledge_misconfigured', message: error.message }, 500) };\n }\n throw error;\n }\n }\n\n routes(): ApiRoute[] {\n const badRequest = (c: Context, message: string) => c.json({ error: 'bad_request', message }, 400);\n return [\n registerApiRoute('/web/factory/projects/:id/knowledge/tree', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const parentId = boundedId(c.req.query('parentId'));\n const cursor = boundedId(c.req.query('cursor'));\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const level = await listKnowledgeTreeChildren(view.store, {\n parentId: parentId ?? null,\n read: view.read,\n cursor,\n limit,\n });\n return c.json({ ...level, pages: level.pages.map(page => withDisplayLabel(view.knowledge, page)) });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/pages/:pageId', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const pageId = boundedId(c.req.param('pageId'));\n if (!pageId) return c.json({ error: 'page_not_found' }, 404);\n const noteLimit = boundedLimit(c.req.query('noteLimit'), MAX_PAGE_LIMIT);\n if (noteLimit === null) return badRequest(c, `noteLimit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const page = await readKnowledgePage(view.store, {\n pageId,\n read: view.read,\n noteCursor: boundedId(c.req.query('noteCursor')),\n noteLimit,\n });\n if (!page) return c.json({ error: 'page_not_found' }, 404);\n const label = <T extends LabelablePage>(entry: T) => withDisplayLabel(view.knowledge, entry);\n return c.json({\n ...page,\n page: label(page.page),\n ancestors: page.ancestors.map(label),\n related: page.related.map(label),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/graph', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const maxPages = boundedLimit(c.req.query('maxPages'), MAX_GRAPH_PAGES);\n if (maxPages === null) return badRequest(c, `maxPages must be an integer from 1 to ${MAX_GRAPH_PAGES}.`);\n const graph = await readKnowledgePageGraph(view.store, {\n read: view.read,\n rootId: boundedId(c.req.query('rootId')) ?? null,\n ...(maxPages ? { limits: { maxPages } } : {}),\n });\n if (!graph) return c.json({ error: 'page_not_found' }, 404);\n // Declared grants between the scopes shown, limited to principal scopes this caller can read.\n const grants = await readKnowledgeScopeGrants(view.store, {\n pages: graph.pages,\n read: view.read,\n grantsFor: scope => view.knowledge.scopeGrants(scope),\n });\n return c.json({\n ...graph,\n pages: graph.pages.map(page => withDisplayLabel(view.knowledge, page)),\n grants: grants.map(grant => {\n const principalLabel = view.knowledge.scopeLabel(grant.principal);\n return principalLabel ? { ...grant, principalLabel } : grant;\n }),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/search', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const query = (c.req.query('q') ?? '').trim();\n if (!query) return c.json({ results: [] });\n if (query.length > SEARCH_QUERY_LIMIT) {\n return badRequest(c, `q must be at most ${SEARCH_QUERY_LIMIT} characters.`);\n }\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const scopeIds = c.req.queries('scopeId')?.flatMap(id => boundedId(id) ?? []);\n const results = await searchKnowledgeExplorerPages(view.store, {\n query,\n read: view.read,\n ...(scopeIds?.length ? { scopeIds } : {}),\n limit,\n });\n return c.json({\n results: results.map(hit => ({ ...hit, page: withDisplayLabel(view.knowledge, hit.page) })),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/events', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const { knowledge, store, read } = view;\n return streamSSE(c, async stream => {\n const closed = new Promise<void>(resolve => stream.onAbort(resolve));\n // Filtering reads the store, so changes are queued to keep them in commit order.\n let queue = Promise.resolve();\n const unsubscribe = knowledge.onChange(event => {\n queue = queue.then(async () => {\n if (stream.aborted) return;\n const change = await visibleChange(store, read, event).catch(() => null);\n if (!change || stream.aborted) return;\n try {\n await stream.writeSSE({ event: 'change', data: JSON.stringify(change) });\n } catch {\n // The tab went away mid-write; abort cleans up.\n }\n });\n });\n const keepalive = setInterval(() => {\n if (!stream.aborted) void stream.write(': ping\\n\\n');\n }, EVENTS_KEEPALIVE_MS);\n let expire: ReturnType<typeof setTimeout> | undefined;\n try {\n await stream.write(': connected\\n\\n');\n // `streamSSE` closes the stream the moment this callback returns.\n await Promise.race([\n closed,\n new Promise<void>(resolve => (expire = setTimeout(resolve, EVENTS_MAX_AGE_MS))),\n ]);\n } finally {\n clearTimeout(expire);\n clearInterval(keepalive);\n unsubscribe();\n }\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/activity', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n return c.json(\n await readKnowledgePageActivity(view.store, {\n read: view.read,\n scopeId: boundedId(c.req.query('scopeId')),\n pageId: boundedId(c.req.query('pageId')),\n cursor: boundedId(c.req.query('cursor')),\n limit,\n }),\n );\n },\n }),\n ];\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"knowledge.js","names":[],"sources":["../../src/routes/knowledge.ts"],"sourcesContent":["/**\n * Read-only Mastra `apiRoutes` behind Factory's Knowledge page: the schema-4 page tree, a page with its\n * notes, the bounded page graph, search and activity, all through the same core page readers Studio uses,\n * plus a change stream (`/events`, SSE) naming the pages and scopes each committed write touched.\n * Every endpoint is a GET; this module never writes Knowledge.\n *\n * Scoping is fail-closed and server-side. The caller must be signed in to an org that owns the `:id`\n * project, and reads are limited to what the Knowledge's own declarations give the principals\n * `org:<orgId>` and `project:<projectId>`: the scopes a run in that project holds at org and project\n * level. Session (`resource:`/`thread:`) scopes are not principals here, so no member browses another\n * member's session pages. The host must declare `project:$projectId` (as its session runs need); without\n * it reads fail with 500 `knowledge_misconfigured`.\n */\n\nimport type { Knowledge, KnowledgeChangeEvent } from '@mastra/core/knowledge';\nimport {\n encodeKnowledgeScopeId,\n KnowledgeDeclarationError,\n listKnowledgeTreeChildren,\n readKnowledgePage,\n readKnowledgePageActivity,\n readKnowledgePageGraph,\n readKnowledgeScopeGrants,\n searchKnowledgeExplorerPages,\n} from '@mastra/core/knowledge';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { KnowledgeReadScope, KnowledgeStorage } from '@mastra/core/storage';\nimport type { Context } from 'hono';\nimport { streamSSE } from 'hono/streaming';\n\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { RouteDependencies } from './route.js';\nimport { loose, Route } from './route.js';\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n/** Ids and cursors are opaque, but bounded so an unbounded query string never reaches storage. */\nconst ID_LIMIT = 256;\nconst SEARCH_QUERY_LIMIT = 128;\nconst MAX_PAGE_LIMIT = 100;\nconst MAX_GRAPH_PAGES = 500;\n/** Comment frames only: proxies drop an idle stream. */\nconst EVENTS_KEEPALIVE_MS = 25_000;\n/**\n * The read scope is resolved when the stream opens. Closing it after this long makes the browser reconnect,\n * which re-checks membership and the read scope, so a revoked member stops hearing about changes.\n */\nconst EVENTS_MAX_AGE_MS = 5 * 60_000;\n\nexport interface KnowledgeRoutesDeps extends RouteDependencies {\n /** Factory projects domain: validates that the `:id` project belongs to the caller's org. */\n projects: FactoryProjectsStorage;\n /** Lazy handle to the host-registered Knowledge runtime; endpoints 503 when absent. */\n knowledge: (key: string) => Promise<Knowledge | undefined>;\n /** Host-selected Knowledge key. Requests cannot override it. */\n defaultKnowledgeKey?: string;\n}\n\ninterface ResolvedView {\n knowledge: Knowledge;\n store: KnowledgeStorage;\n read: KnowledgeReadScope;\n}\n\nfunction boundedId(value: string | undefined): string | undefined {\n if (value === undefined) return undefined;\n const trimmed = value.trim();\n return trimmed && trimmed.length <= ID_LIMIT ? trimmed : undefined;\n}\n\nfunction boundedLimit(value: string | undefined, max: number): number | undefined | null {\n if (value === undefined) return undefined;\n const parsed = Number(value);\n return Number.isInteger(parsed) && parsed >= 1 && parsed <= max ? parsed : null;\n}\n\n/**\n * The ids of a change this caller may see, or null when they may see none of it. Events carry ids only, so\n * readability is checked against the store now: a page moved out of reach is withheld, but the scope it\n * left still tells the caller to refresh.\n */\nasync function visibleChange(store: KnowledgeStorage, read: KnowledgeReadScope, event: KnowledgeChangeEvent) {\n const readable = async (id: string | undefined) =>\n id !== undefined && (read === 'all' || (await store.getPage({ id, read })) !== null);\n const scopeId = 'scopeId' in event ? event.scopeId : undefined;\n const fromScopeId = 'fromScopeId' in event ? event.fromScopeId : undefined;\n const [page, scope, fromScope] = await Promise.all([\n readable(event.pageId),\n readable(scopeId),\n readable(fromScopeId),\n ]);\n if (!page && !scope && !fromScope) return null;\n return {\n kind: event.kind,\n op: event.op,\n ...(page ? { pageId: event.pageId } : {}),\n ...(scope ? { scopeId } : {}),\n at: event.at.toISOString(),\n };\n}\n\ntype LabelablePage = { isScope: boolean; address?: string };\n\n/**\n * Adds a scope page's declared `displayLabel` with the address's `$params` filled in (`'$orgId policy'`\n * → `'acme policy'`); declarations live in config, not storage.\n */\nfunction withDisplayLabel<T extends LabelablePage>(knowledge: Knowledge, page: T): T & { displayLabel?: string } {\n if (!page.isScope || !page.address) return page;\n const displayLabel = knowledge.scopeLabel(page.address);\n return displayLabel ? { ...page, displayLabel } : page;\n}\n\nexport class KnowledgeRoutes extends Route<KnowledgeRoutesDeps> {\n /** Tenant, org-owned project, Knowledge runtime and the caller's read scope: the one seam every route shares. */\n async #resolveView(c: Context): Promise<ResolvedView | { response: Response }> {\n await this.deps.auth.ensureUser(c);\n const tenant = this.deps.auth.tenant(c);\n if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n if (!tenant.orgId) {\n return {\n response: c.json({ error: 'organization_required', message: 'Knowledge requires an organization.' }, 403),\n };\n }\n\n const projectId = c.req.param('id');\n if (!projectId || !UUID_RE.test(projectId)) return { response: c.json({ error: 'Project not found' }, 404) };\n await this.deps.projects.ensureReady();\n const project = await this.deps.projects.get({ orgId: tenant.orgId, id: projectId });\n if (!project) return { response: c.json({ error: 'Project not found' }, 404) };\n\n let knowledge: Knowledge | undefined;\n let store: KnowledgeStorage | undefined;\n try {\n knowledge = await this.deps.knowledge(this.deps.defaultKnowledgeKey ?? 'default');\n store = knowledge ? await knowledge.getStorage() : undefined;\n } catch {\n store = undefined;\n }\n if (!knowledge || !store) {\n return {\n response: c.json(\n { error: 'knowledge_unavailable', message: 'The configured Knowledge runtime is unavailable.' },\n 503,\n ),\n };\n }\n try {\n // The same canonical addresses a Factory session's runs hold (see the SDK's resolveKnowledgeSessionScopes).\n const principals = [\n `org:${encodeKnowledgeScopeId(tenant.orgId)}`,\n `project:${encodeKnowledgeScopeId(projectId)}`,\n ];\n return { knowledge, store, read: await knowledge.readScopeFor(principals) };\n } catch (error) {\n // The host's Knowledge does not declare the scopes a Factory run holds (`org:` and `project:`): a\n // deployment misconfiguration, which its session runs hit too. Never fall back to a guessed scope.\n if (error instanceof KnowledgeDeclarationError) {\n return { response: c.json({ error: 'knowledge_misconfigured', message: error.message }, 500) };\n }\n throw error;\n }\n }\n\n routes(): ApiRoute[] {\n const badRequest = (c: Context, message: string) => c.json({ error: 'bad_request', message }, 400);\n return [\n registerApiRoute('/web/factory/projects/:id/knowledge/tree', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const parentId = boundedId(c.req.query('parentId'));\n const cursor = boundedId(c.req.query('cursor'));\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const level = await listKnowledgeTreeChildren(view.store, {\n parentId: parentId ?? null,\n read: view.read,\n cursor,\n limit,\n });\n return c.json({ ...level, pages: level.pages.map(page => withDisplayLabel(view.knowledge, page)) });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/pages/:pageId', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const pageId = boundedId(c.req.param('pageId'));\n if (!pageId) return c.json({ error: 'page_not_found' }, 404);\n const noteLimit = boundedLimit(c.req.query('noteLimit'), MAX_PAGE_LIMIT);\n if (noteLimit === null) return badRequest(c, `noteLimit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const page = await readKnowledgePage(view.store, {\n pageId,\n read: view.read,\n noteCursor: boundedId(c.req.query('noteCursor')),\n noteLimit,\n });\n if (!page) return c.json({ error: 'page_not_found' }, 404);\n const label = <T extends LabelablePage>(entry: T) => withDisplayLabel(view.knowledge, entry);\n return c.json({\n ...page,\n page: label(page.page),\n ancestors: page.ancestors.map(label),\n related: page.related.map(label),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/graph', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const maxPages = boundedLimit(c.req.query('maxPages'), MAX_GRAPH_PAGES);\n if (maxPages === null) return badRequest(c, `maxPages must be an integer from 1 to ${MAX_GRAPH_PAGES}.`);\n const graph = await readKnowledgePageGraph(view.store, {\n read: view.read,\n rootId: boundedId(c.req.query('rootId')) ?? null,\n ...(maxPages ? { limits: { maxPages } } : {}),\n });\n if (!graph) return c.json({ error: 'page_not_found' }, 404);\n // Declared grants between the scopes shown, limited to principal scopes this caller can read.\n const grants = await readKnowledgeScopeGrants(view.store, {\n pages: graph.pages,\n read: view.read,\n grantsFor: scope => view.knowledge.scopeGrants(scope),\n });\n return c.json({\n ...graph,\n pages: graph.pages.map(page => withDisplayLabel(view.knowledge, page)),\n grants: grants.map(grant => {\n const principalLabel = view.knowledge.scopeLabel(grant.principal);\n return principalLabel ? { ...grant, principalLabel } : grant;\n }),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/search', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const query = (c.req.query('q') ?? '').trim();\n if (!query) return c.json({ results: [] });\n if (query.length > SEARCH_QUERY_LIMIT) {\n return badRequest(c, `q must be at most ${SEARCH_QUERY_LIMIT} characters.`);\n }\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const scopeIds = c.req.queries('scopeId')?.flatMap(id => boundedId(id) ?? []);\n const results = await searchKnowledgeExplorerPages(view.store, {\n query,\n read: view.read,\n ...(scopeIds?.length ? { scopeIds } : {}),\n limit,\n });\n return c.json({\n results: results.map(hit => ({ ...hit, page: withDisplayLabel(view.knowledge, hit.page) })),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/events', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const { knowledge, store, read } = view;\n return streamSSE(c, async stream => {\n const closed = new Promise<void>(resolve => stream.onAbort(resolve));\n // Filtering reads the store, so changes are queued to keep them in commit order.\n let queue = Promise.resolve();\n const unsubscribe = knowledge.onChange(event => {\n queue = queue.then(async () => {\n if (stream.aborted) return;\n const change = await visibleChange(store, read, event).catch(() => null);\n if (!change || stream.aborted) return;\n try {\n await stream.writeSSE({ event: 'change', data: JSON.stringify(change) });\n } catch {\n // The tab went away mid-write; abort cleans up.\n }\n });\n });\n const keepalive = setInterval(() => {\n if (!stream.aborted) void stream.write(': ping\\n\\n');\n }, EVENTS_KEEPALIVE_MS);\n let expire: ReturnType<typeof setTimeout> | undefined;\n try {\n await stream.write(': connected\\n\\n');\n // `streamSSE` closes the stream the moment this callback returns.\n await Promise.race([\n closed,\n new Promise<void>(resolve => (expire = setTimeout(resolve, EVENTS_MAX_AGE_MS))),\n ]);\n } finally {\n clearTimeout(expire);\n clearInterval(keepalive);\n unsubscribe();\n }\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/activity', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n return c.json(\n await readKnowledgePageActivity(view.store, {\n read: view.read,\n scopeId: boundedId(c.req.query('scopeId')),\n pageId: boundedId(c.req.query('pageId')),\n cursor: boundedId(c.req.query('cursor')),\n limit,\n }),\n );\n },\n }),\n ];\n }\n}\n"],"mappings":"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"}
|
|
@@ -25,7 +25,7 @@ export interface SourceControlSessionRoutesOptions {
|
|
|
25
25
|
filesystem?: Pick<FilesystemStorage, 'deleteResourceFiles'>;
|
|
26
26
|
/** How long recreate waits for an aborted run to settle before destroying. */
|
|
27
27
|
abortSettleTimeoutMs?: number;
|
|
28
|
-
workItems?: Pick<WorkItemsStorage, 'clearSessionReferences' | 'hasRunBindingForSession'
|
|
28
|
+
workItems?: Pick<WorkItemsStorage, 'clearSessionReferences' | 'hasRunBindingForSession'> & Partial<Pick<WorkItemsStorage, 'listProjectSubscriptions' | 'listWorkItemSubscribers' | 'findActiveRunBindingForSession' | 'get'>>;
|
|
29
29
|
/** Moves a thread, with everything keyed by its resource, when a session's visibility changes. */
|
|
30
30
|
moveThread?: (input: {
|
|
31
31
|
threadId: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"source-control-sessions.d.ts","sourceRoot":"","sources":["../../src/routes/source-control-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"source-control-sessions.d.ts","sourceRoot":"","sources":["../../src/routes/source-control-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASnE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAarF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAExF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAGV,0BAA0B,EAC3B,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,eAAO,MAAM,0BAA0B,kBAAkB,CAAC;AAc1D,KAAK,wBAAwB,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;AAE1G,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,SAAS,CAAC;IAChB,cAAc,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACtD,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,UAAU,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,IAAI,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IACnD,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IACjD,mFAAmF;IACnF,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,sGAAsG;IACtG,UAAU,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;IAC5D,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,wBAAwB,GAAG,yBAAyB,CAAC,GACtF,OAAO,CACL,IAAI,CACF,gBAAgB,EAChB,0BAA0B,GAAG,yBAAyB,GAAG,gCAAgC,GAAG,KAAK,CAClG,CACF,CAAC;IACJ,kGAAkG;IAClG,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AA6eD,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,iCAAiC,GAAG,QAAQ,EAAE,CAgetG"}
|
|
@@ -5,10 +5,13 @@ import { seedSessionOrg } from "../session/org-seed.js";
|
|
|
5
5
|
import { isRunBound, isWorkerSession, listFactorySessionThreads, sessionMemoryResourceId, sessionThreadsToMove, userSessionResourceFor } from "../session/session-threads.js";
|
|
6
6
|
import { normalizeSessionTitle } from "../session/session-title.js";
|
|
7
7
|
import { SESSION_OWNER_SIGNAL_TAG } from "../session-owner-signal.js";
|
|
8
|
+
import { isFactoryPrincipalId } from "../storage/domains/projects/base.js";
|
|
9
|
+
import { answerParkedCall } from "../tools/approval-tools.js";
|
|
8
10
|
import { loose } from "./route.js";
|
|
9
11
|
import { canReadSessionResource, canSwitchSessionModel, canViewSourceControlSession } from "./session-access.js";
|
|
10
12
|
import { RequestContext } from "@mastra/core/request-context";
|
|
11
13
|
import { registerApiRoute } from "@mastra/core/server";
|
|
14
|
+
import { z } from "zod";
|
|
12
15
|
import { UniqueViolationError } from "@mastra/core/storage";
|
|
13
16
|
import { resolveModel } from "@mastra/code-sdk/agents/model";
|
|
14
17
|
import { createSignal } from "@mastra/core/signals";
|
|
@@ -33,6 +36,31 @@ async function sessionManagePermission(c, auth, tenant, session) {
|
|
|
33
36
|
if (isOwner) return "allowed";
|
|
34
37
|
return await auth.isOrganizationAdmin(c, session.orgId) ? "allowed" : "forbidden";
|
|
35
38
|
}
|
|
39
|
+
const parkedApprovalAnswerSchema = z.object({
|
|
40
|
+
decision: z.enum(["approve", "decline"]),
|
|
41
|
+
reason: z.string().trim().min(1).max(1e3).optional(),
|
|
42
|
+
toolCallId: z.string().trim().min(1).max(200).optional()
|
|
43
|
+
}).strict();
|
|
44
|
+
/** Whether the viewer asked for the card's work: they filed it, or a session of theirs follows it. */
|
|
45
|
+
async function followsCard(options, workItemId, tenant) {
|
|
46
|
+
const workItems = options.workItems;
|
|
47
|
+
if (!workItemId || !workItems?.get || !workItems.listWorkItemSubscribers) return false;
|
|
48
|
+
const item = await workItems.get({
|
|
49
|
+
orgId: tenant.orgId,
|
|
50
|
+
id: workItemId
|
|
51
|
+
});
|
|
52
|
+
if (!item) return false;
|
|
53
|
+
if (item.createdBy === tenant.userId) return true;
|
|
54
|
+
const followers = await workItems.listWorkItemSubscribers({
|
|
55
|
+
orgId: tenant.orgId,
|
|
56
|
+
workItemId
|
|
57
|
+
});
|
|
58
|
+
for (const sessionId of new Set(followers.map((follower) => follower.sessionId))) {
|
|
59
|
+
const following = (await resolveSession(options.sourceControls, sessionId))?.session;
|
|
60
|
+
if (following?.orgId === tenant.orgId && following.userId === tenant.userId) return true;
|
|
61
|
+
}
|
|
62
|
+
return false;
|
|
63
|
+
}
|
|
36
64
|
function canRecreateSandbox(options) {
|
|
37
65
|
return Boolean(options.sessionRetirement) && options.sandboxRecreateSupported === true;
|
|
38
66
|
}
|
|
@@ -220,9 +248,13 @@ function createSessionOwnerProfileResolver(users) {
|
|
|
220
248
|
}
|
|
221
249
|
};
|
|
222
250
|
return async (userIds) => {
|
|
223
|
-
if (!users) return /* @__PURE__ */ new Map();
|
|
224
|
-
const requestedUserIds = [...new Set(userIds)].slice(0, MAX_SESSION_OWNER_PROFILES);
|
|
225
251
|
const profiles = /* @__PURE__ */ new Map();
|
|
252
|
+
for (const userId of userIds) if (isFactoryPrincipalId(userId)) profiles.set(userId, {
|
|
253
|
+
id: userId,
|
|
254
|
+
name: "Factory"
|
|
255
|
+
});
|
|
256
|
+
if (!users) return profiles;
|
|
257
|
+
const requestedUserIds = [...new Set(userIds)].filter((userId) => !isFactoryPrincipalId(userId)).slice(0, MAX_SESSION_OWNER_PROFILES);
|
|
226
258
|
const unresolvedUserIds = [];
|
|
227
259
|
const now = Date.now();
|
|
228
260
|
for (const userId of requestedUserIds) {
|
|
@@ -373,7 +405,81 @@ function buildSourceControlSessionRoutes(options) {
|
|
|
373
405
|
viewerUserId: userId
|
|
374
406
|
})))).flat();
|
|
375
407
|
const owners = await resolveOwnerProfiles(sessions.map((session) => session.userId));
|
|
376
|
-
|
|
408
|
+
const followed = /* @__PURE__ */ new Map();
|
|
409
|
+
for (const link of await options.workItems?.listProjectSubscriptions?.({
|
|
410
|
+
orgId,
|
|
411
|
+
factoryProjectId: project.id
|
|
412
|
+
}) ?? []) {
|
|
413
|
+
const workItemIds = followed.get(link.sessionId);
|
|
414
|
+
if (workItemIds) workItemIds.push(link.workItemId);
|
|
415
|
+
else followed.set(link.sessionId, [link.workItemId]);
|
|
416
|
+
}
|
|
417
|
+
return c.json({ sessions: sessions.map((session) => ({
|
|
418
|
+
...withOwnerProfile(session, owners),
|
|
419
|
+
followedWorkItemIds: followed.get(session.sessionId) ?? []
|
|
420
|
+
})) });
|
|
421
|
+
}
|
|
422
|
+
}),
|
|
423
|
+
registerApiRoute("/web/user-sessions/:sessionId/parked-approval", {
|
|
424
|
+
method: "POST",
|
|
425
|
+
requiresAuth: false,
|
|
426
|
+
handler: async (c) => {
|
|
427
|
+
const resolved = await resolveOrgTenant(loose(c), options.auth);
|
|
428
|
+
if ("response" in resolved) return resolved.response;
|
|
429
|
+
const body = parkedApprovalAnswerSchema.safeParse(await c.req.json().catch(() => null));
|
|
430
|
+
if (!body.success) return c.json({ error: "Send a decision of \"approve\" or \"decline\", and optionally a reason and toolCallId." }, 400);
|
|
431
|
+
const session = (await resolveSession(options.sourceControls, c.req.param("sessionId")))?.session;
|
|
432
|
+
if (!session) return c.json({ error: "Session not found" }, 404);
|
|
433
|
+
const permission = await sessionManagePermission(loose(c), options.auth, resolved.tenant, session);
|
|
434
|
+
if (permission === "not-found") return c.json({ error: "Session not found" }, 404);
|
|
435
|
+
const binding = session.factoryProjectId && options.workItems?.findActiveRunBindingForSession ? await options.workItems.findActiveRunBindingForSession({
|
|
436
|
+
orgId: session.orgId,
|
|
437
|
+
factoryProjectId: session.factoryProjectId,
|
|
438
|
+
sessionId: session.sessionId
|
|
439
|
+
}) : null;
|
|
440
|
+
if (permission !== "allowed" && !await followsCard(options, binding?.workItemId, resolved.tenant)) return c.json({ error: "Only the session's owner, an organization admin, or someone following its card can answer." }, 403);
|
|
441
|
+
const controller = options.controller;
|
|
442
|
+
if (!controller) return c.json({ error: "Sessions are not available on this server." }, 503);
|
|
443
|
+
const { decision, reason } = body.data;
|
|
444
|
+
let answered;
|
|
445
|
+
try {
|
|
446
|
+
answered = await answerParkedCall({ messaging: async () => ({ controller }) }, {
|
|
447
|
+
session,
|
|
448
|
+
...body.data.toolCallId ? { toolCallId: body.data.toolCallId } : {},
|
|
449
|
+
decision,
|
|
450
|
+
declineReason: reason ?? "Declined from the card."
|
|
451
|
+
});
|
|
452
|
+
} catch (error) {
|
|
453
|
+
return c.json({ error: error instanceof Error ? error.message : String(error) }, 409);
|
|
454
|
+
}
|
|
455
|
+
const { toolCallId, toolName } = answered;
|
|
456
|
+
await options.audit?.record({
|
|
457
|
+
orgId: session.orgId,
|
|
458
|
+
actorId: resolved.tenant.userId,
|
|
459
|
+
actorType: "human",
|
|
460
|
+
action: decision === "approve" ? "factory.run.approved" : "factory.run.dismissed",
|
|
461
|
+
...session.factoryProjectId ? { factoryProjectId: session.factoryProjectId } : {},
|
|
462
|
+
targets: [{
|
|
463
|
+
type: "session",
|
|
464
|
+
id: session.sessionId
|
|
465
|
+
}, ...binding ? [{
|
|
466
|
+
type: "work_item",
|
|
467
|
+
id: binding.workItemId
|
|
468
|
+
}] : []],
|
|
469
|
+
metadata: {
|
|
470
|
+
toolCallId,
|
|
471
|
+
toolName,
|
|
472
|
+
sessionId: session.sessionId,
|
|
473
|
+
decision,
|
|
474
|
+
cause: "web"
|
|
475
|
+
}
|
|
476
|
+
});
|
|
477
|
+
return c.json({
|
|
478
|
+
answered: decision,
|
|
479
|
+
sessionId: session.sessionId,
|
|
480
|
+
toolCallId,
|
|
481
|
+
toolName
|
|
482
|
+
});
|
|
377
483
|
}
|
|
378
484
|
}),
|
|
379
485
|
...projectSessionRoutes("/web/source-control/projects/:id/sessions", options, resolveOwnerProfiles),
|