@mastra/factory 0.28.0-alpha.13 → 0.28.0-alpha.14
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 +31 -18
- package/dist/environment/build-runner.d.ts +13 -2
- package/dist/environment/build-runner.d.ts.map +1 -1
- package/dist/environment/build-runner.js +42 -0
- package/dist/environment/build-runner.js.map +1 -1
- package/dist/environment/build-workflow.d.ts +6 -4
- package/dist/environment/build-workflow.d.ts.map +1 -1
- package/dist/environment/build-workflow.js +70 -66
- package/dist/environment/build-workflow.js.map +1 -1
- package/dist/environment/build.d.ts +19 -4
- package/dist/environment/build.d.ts.map +1 -1
- package/dist/environment/build.js +70 -14
- package/dist/environment/build.js.map +1 -1
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +21 -21
- package/dist/factory.js.map +1 -1
- package/dist/integrations/github/sandbox-release.d.ts +12 -0
- package/dist/integrations/github/sandbox-release.d.ts.map +1 -1
- package/dist/integrations/github/sandbox-release.js +16 -1
- package/dist/integrations/github/sandbox-release.js.map +1 -1
- package/dist/routes/board-snapshot.d.ts +5 -0
- package/dist/routes/board-snapshot.d.ts.map +1 -1
- package/dist/routes/board-snapshot.js +12 -1
- package/dist/routes/board-snapshot.js.map +1 -1
- package/dist/routes/contracts.d.ts +66 -0
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +41 -1
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/projects.d.ts.map +1 -1
- package/dist/routes/projects.js +5 -0
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/sandbox-envs.d.ts +2 -0
- package/dist/routes/sandbox-envs.d.ts.map +1 -1
- package/dist/routes/sandbox-envs.js +3 -0
- package/dist/routes/sandbox-envs.js.map +1 -1
- package/dist/routes/source-control-settings.d.ts +2 -0
- package/dist/routes/source-control-settings.d.ts.map +1 -1
- package/dist/routes/source-control-settings.js +5 -0
- package/dist/routes/source-control-settings.js.map +1 -1
- package/dist/routes/surface.d.ts +2 -0
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +2 -1
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/work-item-activity.d.ts +11 -0
- package/dist/routes/work-item-activity.d.ts.map +1 -0
- package/dist/routes/work-item-activity.js +25 -0
- package/dist/routes/work-item-activity.js.map +1 -0
- package/dist/routes/work-item-starters.d.ts +29 -0
- package/dist/routes/work-item-starters.d.ts.map +1 -0
- package/dist/routes/work-item-starters.js +169 -0
- package/dist/routes/work-item-starters.js.map +1 -0
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +59 -1
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/transition-service.d.ts +20 -2
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +40 -18
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/sandbox/context-sandboxes.d.ts +70 -0
- package/dist/sandbox/context-sandboxes.d.ts.map +1 -0
- package/dist/sandbox/context-sandboxes.js +120 -0
- package/dist/sandbox/context-sandboxes.js.map +1 -0
- package/dist/sandbox/session-retirement.d.ts +11 -4
- package/dist/sandbox/session-retirement.d.ts.map +1 -1
- package/dist/sandbox/session-retirement.js +39 -13
- package/dist/sandbox/session-retirement.js.map +1 -1
- package/dist/storage/domains/projects/base.d.ts +8 -2
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +21 -4
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/tools/annotations.d.ts.map +1 -1
- package/dist/tools/annotations.js +4 -0
- package/dist/tools/annotations.js.map +1 -1
- package/dist/tools/audit-events-tool.d.ts +29 -0
- package/dist/tools/audit-events-tool.d.ts.map +1 -0
- package/dist/tools/audit-events-tool.js +180 -0
- package/dist/tools/audit-events-tool.js.map +1 -0
- package/dist/tools/index.d.ts +2 -1
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +2 -0
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/permissions.d.ts.map +1 -1
- package/dist/tools/permissions.js +1 -0
- package/dist/tools/permissions.js.map +1 -1
- package/package.json +9 -9
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
import { auditActionsInNamespaces, auditNamespaces, isAuditAction } from "../storage/domains/audit/actions.js";
|
|
2
|
+
import { ACTOR_PROFILE_METADATA_KEY, auditCursorAt, decodeAuditAfterCursor, encodeAuditCursor } from "../storage/domains/audit/base.js";
|
|
3
|
+
import { findWorkItem, truncate, workItemNotFound, workItemRefSchema } from "./read-tools.js";
|
|
4
|
+
import { createTool } from "@mastra/core/tools";
|
|
5
|
+
import { z } from "zod";
|
|
6
|
+
// src/tools/audit-events-tool.ts
|
|
7
|
+
const DEFAULT_LIMIT = 25;
|
|
8
|
+
const PAGE_SIZE = 200;
|
|
9
|
+
/** Pages read per call before handing back a cursor, so a narrow filter can't scan the whole trail at once. */
|
|
10
|
+
const MAX_PAGES = 5;
|
|
11
|
+
const AGENT_ACTOR_PREFIX = "agent:";
|
|
12
|
+
const SESSION_ACTOR_PREFIX = "session:";
|
|
13
|
+
const namespaces = auditNamespaces();
|
|
14
|
+
const inputSchema = z.object({
|
|
15
|
+
actor: z.string().trim().min(1).max(200).optional().describe("\"me\", a user id, or an agent actor id like \"agent:<threadId>\". Only events this actor performed."),
|
|
16
|
+
includeAgentRuns: z.boolean().optional().describe("With a person as `actor`: also include what agents did in runs that person started."),
|
|
17
|
+
namespace: z.enum(namespaces).optional().describe("Only actions in this namespace, e.g. \"work_item\" or \"run\"."),
|
|
18
|
+
actions: z.array(z.string().refine(isAuditAction, { message: "Not a Factory audit action." })).min(1).max(50).optional().describe("Only these exact actions, e.g. [\"factory.work_item.stage_moved\"]."),
|
|
19
|
+
workItem: workItemRefSchema.optional().describe("Only events that acted on this work item (id or \"#123\")."),
|
|
20
|
+
since: z.iso.datetime({ offset: true }).optional().describe("Only events at or after this ISO time."),
|
|
21
|
+
until: z.iso.datetime({ offset: true }).optional().describe("Only events before this ISO time."),
|
|
22
|
+
cursor: z.string().min(1).max(200).optional().describe("`nextCursor` from a previous call, to read older events."),
|
|
23
|
+
limit: z.number().int().min(1).max(50).optional().describe(`Default ${DEFAULT_LIMIT}, max 50.`)
|
|
24
|
+
}).strict();
|
|
25
|
+
/** A display name stamped at record time, or nothing when it is an email (the fallback when a person has no name). */
|
|
26
|
+
function actorName(event) {
|
|
27
|
+
const profile = event.metadata?.[ACTOR_PROFILE_METADATA_KEY];
|
|
28
|
+
const name = typeof profile?.name === "string" ? profile.name.trim() : "";
|
|
29
|
+
return name && !name.includes("@") ? truncate(name, 600) : void 0;
|
|
30
|
+
}
|
|
31
|
+
function startedBy(event) {
|
|
32
|
+
const value = event.metadata?.startedBy;
|
|
33
|
+
return event.actorType === "agent" && typeof value === "string" ? value : void 0;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Who did what in this Factory, from its audit trail. The trail is org-wide and
|
|
37
|
+
* its reads are unscoped by design, so this tool narrows what it hands back:
|
|
38
|
+
* only this Factory's events, never request context (IP, user agent), names but
|
|
39
|
+
* never emails, no metadata beyond what was acted on, and no events from or
|
|
40
|
+
* about another person's private session.
|
|
41
|
+
*/
|
|
42
|
+
function createAuditEventsTool(scope, deps) {
|
|
43
|
+
const project = {
|
|
44
|
+
orgId: scope.orgId,
|
|
45
|
+
factoryProjectId: scope.factoryProjectId
|
|
46
|
+
};
|
|
47
|
+
return createTool({
|
|
48
|
+
id: "factory_list_audit_events",
|
|
49
|
+
description: "List this Factory's audit events, newest first: who did what to which work item, run, branch or setting, and when. Filter by actor (\"me\" or a user id, optionally with the agent runs they started), action namespace or exact actions, work item, and time range. Pass `nextCursor` back as `cursor` for older events. Events from other people's private sessions are left out.",
|
|
50
|
+
inputSchema,
|
|
51
|
+
execute: async (input) => {
|
|
52
|
+
if (input.cursor && !decodeAuditAfterCursor(input.cursor)) throw new Error("That cursor is not one this tool returned.");
|
|
53
|
+
const since = input.since ? new Date(input.since) : void 0;
|
|
54
|
+
const until = input.until ? new Date(input.until) : void 0;
|
|
55
|
+
if (since && until && since >= until) throw new Error("`since` must be before `until`.");
|
|
56
|
+
if (input.includeAgentRuns && (!input.actor || input.actor.startsWith(AGENT_ACTOR_PREFIX))) throw new Error("`includeAgentRuns` needs a person as `actor`.");
|
|
57
|
+
let workItemId;
|
|
58
|
+
if (input.workItem) {
|
|
59
|
+
const item = await findWorkItem(deps.workItems, scope, input.workItem);
|
|
60
|
+
if (!item) throw workItemNotFound(input.workItem);
|
|
61
|
+
workItemId = item.id;
|
|
62
|
+
}
|
|
63
|
+
const namespaceActions = input.namespace ? auditActionsInNamespaces([input.namespace]) : void 0;
|
|
64
|
+
const actions = input.actions && namespaceActions ? input.actions.filter((action) => namespaceActions.includes(action)) : input.actions ?? namespaceActions;
|
|
65
|
+
if (actions && actions.length === 0) return { events: [] };
|
|
66
|
+
const actorId = input.actor === "me" ? scope.userId : input.actor;
|
|
67
|
+
const limit = input.limit ?? DEFAULT_LIMIT;
|
|
68
|
+
const visible = eventVisibility(scope, deps);
|
|
69
|
+
const events = [];
|
|
70
|
+
let before = input.cursor ?? (until ? auditCursorAt(until) : void 0);
|
|
71
|
+
const beforeUntil = (event) => !until || event.occurredAt < until;
|
|
72
|
+
for (let page = 0; page < MAX_PAGES; page++) {
|
|
73
|
+
const result = await deps.audit.list({
|
|
74
|
+
...project,
|
|
75
|
+
...actions ? { actions } : {},
|
|
76
|
+
...actorId && !input.includeAgentRuns ? { actorId } : {},
|
|
77
|
+
...before ? { before } : {},
|
|
78
|
+
limit: PAGE_SIZE
|
|
79
|
+
});
|
|
80
|
+
for (const event of result.events) {
|
|
81
|
+
if (since && event.occurredAt < since) return { events };
|
|
82
|
+
if (!beforeUntil(event)) continue;
|
|
83
|
+
if (actorId && event.actorId !== actorId && startedBy(event) !== actorId) continue;
|
|
84
|
+
if (workItemId && !event.targets.some((target) => target.type === "work_item" && target.id === workItemId)) continue;
|
|
85
|
+
if (!await visible(event)) continue;
|
|
86
|
+
events.push(summarize(event));
|
|
87
|
+
if (events.length === limit) return {
|
|
88
|
+
events,
|
|
89
|
+
nextCursor: encodeAuditCursor(event)
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
if (!result.nextCursor) return { events };
|
|
93
|
+
before = result.nextCursor;
|
|
94
|
+
}
|
|
95
|
+
return {
|
|
96
|
+
events,
|
|
97
|
+
nextCursor: before
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
});
|
|
101
|
+
}
|
|
102
|
+
function summarize(event) {
|
|
103
|
+
const name = actorName(event);
|
|
104
|
+
const runStartedBy = startedBy(event);
|
|
105
|
+
return {
|
|
106
|
+
action: event.action,
|
|
107
|
+
occurredAt: event.occurredAt.toISOString(),
|
|
108
|
+
actor: {
|
|
109
|
+
type: event.actorType,
|
|
110
|
+
id: event.actorId,
|
|
111
|
+
...name ? { name } : {}
|
|
112
|
+
},
|
|
113
|
+
...runStartedBy ? { startedBy: runStartedBy } : {},
|
|
114
|
+
targets: event.targets.slice(0, 10).map((target) => ({
|
|
115
|
+
type: target.type,
|
|
116
|
+
id: truncate(target.id, 600),
|
|
117
|
+
...target.name ? { name: truncate(target.name, 600) } : {}
|
|
118
|
+
}))
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
/** Sessions an event names: its session targets and the session it records it acted in. */
|
|
122
|
+
function sessionRefs(event) {
|
|
123
|
+
const ids = event.targets.filter((target) => target.type === "session").map((target) => target.id);
|
|
124
|
+
const recorded = event.metadata?.sessionId;
|
|
125
|
+
if (typeof recorded === "string") ids.push(recorded);
|
|
126
|
+
return [...new Set(ids)];
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* Whether the caller may see an event. An event that names a session, or an
|
|
130
|
+
* agent's act (which belongs to the session it ran in), is only visible when
|
|
131
|
+
* every such session is shared or the caller's own. Fails closed when a
|
|
132
|
+
* session can't be found.
|
|
133
|
+
*/
|
|
134
|
+
function eventVisibility(scope, deps) {
|
|
135
|
+
const sessions = /* @__PURE__ */ new Map();
|
|
136
|
+
const threads = /* @__PURE__ */ new Map();
|
|
137
|
+
let runAgents;
|
|
138
|
+
const sessionVisible = (sessionId) => {
|
|
139
|
+
let result = sessions.get(sessionId);
|
|
140
|
+
if (!result) {
|
|
141
|
+
result = (async () => {
|
|
142
|
+
const row = await deps.sessions?.getBySessionId(sessionId);
|
|
143
|
+
if (!row || row.orgId !== scope.orgId || row.factoryProjectId !== scope.factoryProjectId) return false;
|
|
144
|
+
return row.visibility !== "private" || row.userId === scope.userId;
|
|
145
|
+
})().catch(() => false);
|
|
146
|
+
sessions.set(sessionId, result);
|
|
147
|
+
}
|
|
148
|
+
return result;
|
|
149
|
+
};
|
|
150
|
+
const threadVisible = async (threadId) => {
|
|
151
|
+
runAgents ??= deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId).then((bindings) => new Set(bindings.flatMap((binding) => [binding.threadId, binding.id])));
|
|
152
|
+
if ((await runAgents).has(threadId)) return true;
|
|
153
|
+
const controller = (await deps.messaging?.())?.controller;
|
|
154
|
+
if (!controller) return false;
|
|
155
|
+
const thread = await controller.queryThreadById({ threadId });
|
|
156
|
+
if (!thread) return false;
|
|
157
|
+
const stamped = thread.metadata?.factorySessionId;
|
|
158
|
+
return sessionVisible(typeof stamped === "string" ? stamped : thread.id);
|
|
159
|
+
};
|
|
160
|
+
const agentVisible = (event) => {
|
|
161
|
+
if (startedBy(event) === scope.userId) return true;
|
|
162
|
+
if (!event.actorId.startsWith(AGENT_ACTOR_PREFIX)) return false;
|
|
163
|
+
const threadId = event.actorId.slice(6);
|
|
164
|
+
let result = threads.get(threadId);
|
|
165
|
+
if (!result) {
|
|
166
|
+
const sessionId = threadId.startsWith(SESSION_ACTOR_PREFIX) ? threadId.slice(8) : void 0;
|
|
167
|
+
result = (sessionId ? sessionVisible(sessionId) : threadVisible(threadId)).catch(() => false);
|
|
168
|
+
threads.set(threadId, result);
|
|
169
|
+
}
|
|
170
|
+
return result;
|
|
171
|
+
};
|
|
172
|
+
return async (event) => {
|
|
173
|
+
if (event.actorType === "agent" && !await agentVisible(event)) return false;
|
|
174
|
+
for (const sessionId of sessionRefs(event)) if (!await sessionVisible(sessionId)) return false;
|
|
175
|
+
return true;
|
|
176
|
+
};
|
|
177
|
+
}
|
|
178
|
+
export { createAuditEventsTool };
|
|
179
|
+
|
|
180
|
+
//# sourceMappingURL=audit-events-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"audit-events-tool.js","names":[],"sources":["../../src/tools/audit-events-tool.ts"],"sourcesContent":["import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport { auditActionsInNamespaces, auditNamespaces, isAuditAction } from '../storage/domains/audit/actions.js';\nimport type { AuditNamespace } from '../storage/domains/audit/actions.js';\nimport {\n ACTOR_PROFILE_METADATA_KEY,\n auditCursorAt,\n decodeAuditAfterCursor,\n encodeAuditCursor,\n} from '../storage/domains/audit/base.js';\nimport type { AuditEventRow } from '../storage/domains/audit/base.js';\nimport type { FactoryReadToolDependencies } from './read-tools.js';\nimport { MAX_LIST, MAX_TEXT, findWorkItem, truncate, workItemNotFound, workItemRefSchema } from './read-tools.js';\nimport type { FactoryToolScope } from './scope.js';\n\nconst DEFAULT_LIMIT = 25;\nconst PAGE_SIZE = 200;\n/** Pages read per call before handing back a cursor, so a narrow filter can't scan the whole trail at once. */\nconst MAX_PAGES = 5;\nconst AGENT_ACTOR_PREFIX = 'agent:';\nconst SESSION_ACTOR_PREFIX = 'session:';\n\nexport interface FactoryAuditToolDependencies {\n workItems: FactoryReadToolDependencies['workItems'];\n audit: FactoryReadToolDependencies['audit'];\n messaging?: FactoryReadToolDependencies['messaging'];\n /** Finds the sessions an event names or an agent ran in, to leave out other people's private sessions. */\n sessions?: Pick<SourceControlSessionLookup, 'getBySessionId'>;\n}\n\nconst namespaces = auditNamespaces() as [AuditNamespace, ...AuditNamespace[]];\n\nconst inputSchema = z\n .object({\n actor: z\n .string()\n .trim()\n .min(1)\n .max(200)\n .optional()\n .describe('\"me\", a user id, or an agent actor id like \"agent:<threadId>\". Only events this actor performed.'),\n includeAgentRuns: z\n .boolean()\n .optional()\n .describe('With a person as `actor`: also include what agents did in runs that person started.'),\n namespace: z.enum(namespaces).optional().describe('Only actions in this namespace, e.g. \"work_item\" or \"run\".'),\n actions: z\n .array(z.string().refine(isAuditAction, { message: 'Not a Factory audit action.' }))\n .min(1)\n .max(50)\n .optional()\n .describe('Only these exact actions, e.g. [\"factory.work_item.stage_moved\"].'),\n workItem: workItemRefSchema.optional().describe('Only events that acted on this work item (id or \"#123\").'),\n since: z.iso.datetime({ offset: true }).optional().describe('Only events at or after this ISO time.'),\n until: z.iso.datetime({ offset: true }).optional().describe('Only events before this ISO time.'),\n cursor: z.string().min(1).max(200).optional().describe('`nextCursor` from a previous call, to read older events.'),\n limit: z.number().int().min(1).max(MAX_LIST).optional().describe(`Default ${DEFAULT_LIMIT}, max ${MAX_LIST}.`),\n })\n .strict();\n\n/** A display name stamped at record time, or nothing when it is an email (the fallback when a person has no name). */\nfunction actorName(event: AuditEventRow): string | undefined {\n const profile = event.metadata?.[ACTOR_PROFILE_METADATA_KEY] as { name?: unknown } | undefined;\n const name = typeof profile?.name === 'string' ? profile.name.trim() : '';\n return name && !name.includes('@') ? truncate(name, MAX_TEXT) : undefined;\n}\n\nfunction startedBy(event: AuditEventRow): string | undefined {\n const value = event.metadata?.startedBy;\n return event.actorType === 'agent' && typeof value === 'string' ? value : undefined;\n}\n\n/**\n * Who did what in this Factory, from its audit trail. The trail is org-wide and\n * its reads are unscoped by design, so this tool narrows what it hands back:\n * only this Factory's events, never request context (IP, user agent), names but\n * never emails, no metadata beyond what was acted on, and no events from or\n * about another person's private session.\n */\nexport function createAuditEventsTool(scope: FactoryToolScope, deps: FactoryAuditToolDependencies) {\n const project = { orgId: scope.orgId, factoryProjectId: scope.factoryProjectId };\n\n return createTool({\n id: 'factory_list_audit_events',\n description:\n 'List this Factory\\'s audit events, newest first: who did what to which work item, run, branch or setting, and when. Filter by actor (\"me\" or a user id, optionally with the agent runs they started), action namespace or exact actions, work item, and time range. Pass `nextCursor` back as `cursor` for older events. Events from other people\\'s private sessions are left out.',\n inputSchema,\n execute: async input => {\n if (input.cursor && !decodeAuditAfterCursor(input.cursor)) {\n throw new Error('That cursor is not one this tool returned.');\n }\n const since = input.since ? new Date(input.since) : undefined;\n const until = input.until ? new Date(input.until) : undefined;\n if (since && until && since >= until) throw new Error('`since` must be before `until`.');\n if (input.includeAgentRuns && (!input.actor || input.actor.startsWith(AGENT_ACTOR_PREFIX))) {\n throw new Error('`includeAgentRuns` needs a person as `actor`.');\n }\n\n let workItemId: string | undefined;\n if (input.workItem) {\n const item = await findWorkItem(deps.workItems, scope, input.workItem);\n if (!item) throw workItemNotFound(input.workItem);\n workItemId = item.id;\n }\n\n const namespaceActions = input.namespace ? auditActionsInNamespaces([input.namespace]) : undefined;\n const actions =\n input.actions && namespaceActions\n ? input.actions.filter(action => namespaceActions.includes(action))\n : (input.actions ?? namespaceActions);\n if (actions && actions.length === 0) return { events: [] };\n\n const actorId = input.actor === 'me' ? scope.userId : input.actor;\n const limit = input.limit ?? DEFAULT_LIMIT;\n const visible = eventVisibility(scope, deps);\n\n const events: ReturnType<typeof summarize>[] = [];\n let before = input.cursor ?? (until ? auditCursorAt(until) : undefined);\n // `auditCursorAt` sits after every row at that instant; `until` excludes them.\n const beforeUntil = (event: AuditEventRow) => !until || event.occurredAt < until;\n for (let page = 0; page < MAX_PAGES; page++) {\n const result = await deps.audit.list({\n ...project,\n ...(actions ? { actions } : {}),\n ...(actorId && !input.includeAgentRuns ? { actorId } : {}),\n ...(before ? { before } : {}),\n limit: PAGE_SIZE,\n });\n for (const event of result.events) {\n if (since && event.occurredAt < since) return { events };\n if (!beforeUntil(event)) continue;\n if (actorId && event.actorId !== actorId && startedBy(event) !== actorId) continue;\n if (workItemId && !event.targets.some(target => target.type === 'work_item' && target.id === workItemId)) {\n continue;\n }\n if (!(await visible(event))) continue;\n events.push(summarize(event));\n if (events.length === limit) return { events, nextCursor: encodeAuditCursor(event) };\n }\n if (!result.nextCursor) return { events };\n before = result.nextCursor;\n }\n // Scan budget spent: hand back where to pick up, even with fewer events than asked for.\n return { events, nextCursor: before };\n },\n });\n}\n\nfunction summarize(event: AuditEventRow) {\n const name = actorName(event);\n const runStartedBy = startedBy(event);\n return {\n action: event.action,\n occurredAt: event.occurredAt.toISOString(),\n actor: { type: event.actorType, id: event.actorId, ...(name ? { name } : {}) },\n ...(runStartedBy ? { startedBy: runStartedBy } : {}),\n targets: event.targets.slice(0, 10).map(target => ({\n type: target.type,\n id: truncate(target.id, MAX_TEXT),\n ...(target.name ? { name: truncate(target.name, MAX_TEXT) } : {}),\n })),\n };\n}\n\n/** Sessions an event names: its session targets and the session it records it acted in. */\nfunction sessionRefs(event: AuditEventRow): string[] {\n const ids = event.targets.filter(target => target.type === 'session').map(target => target.id);\n const recorded = event.metadata?.sessionId;\n if (typeof recorded === 'string') ids.push(recorded);\n return [...new Set(ids)];\n}\n\n/**\n * Whether the caller may see an event. An event that names a session, or an\n * agent's act (which belongs to the session it ran in), is only visible when\n * every such session is shared or the caller's own. Fails closed when a\n * session can't be found.\n */\nfunction eventVisibility(scope: FactoryToolScope, deps: FactoryAuditToolDependencies) {\n const sessions = new Map<string, Promise<boolean>>();\n const threads = new Map<string, Promise<boolean>>();\n let runAgents: Promise<Set<string>> | undefined;\n\n const sessionVisible = (sessionId: string): Promise<boolean> => {\n let result = sessions.get(sessionId);\n if (!result) {\n result = (async () => {\n const row = await deps.sessions?.getBySessionId(sessionId);\n if (!row || row.orgId !== scope.orgId || row.factoryProjectId !== scope.factoryProjectId) return false;\n return row.visibility !== 'private' || row.userId === scope.userId;\n })().catch(() => false);\n sessions.set(sessionId, result);\n }\n return result;\n };\n\n const threadVisible = async (threadId: string): Promise<boolean> => {\n // Work item runs are on the board for everyone in the Factory. A run's agent is recorded\n // under its thread (commits, pushes, signals) or under its binding (stage moves).\n runAgents ??= deps.workItems\n .listRunBindings(scope.orgId, scope.factoryProjectId)\n .then(bindings => new Set(bindings.flatMap(binding => [binding.threadId, binding.id])));\n if ((await runAgents).has(threadId)) return true;\n\n const controller = (await deps.messaging?.())?.controller;\n if (!controller) return false;\n const thread = await controller.queryThreadById({ threadId });\n if (!thread) return false;\n const stamped = thread.metadata?.factorySessionId;\n return sessionVisible(typeof stamped === 'string' ? stamped : thread.id);\n };\n\n const agentVisible = (event: AuditEventRow): Promise<boolean> | boolean => {\n if (startedBy(event) === scope.userId) return true;\n if (!event.actorId.startsWith(AGENT_ACTOR_PREFIX)) return false;\n const threadId = event.actorId.slice(AGENT_ACTOR_PREFIX.length);\n let result = threads.get(threadId);\n if (!result) {\n // Turns nobody signed in started are recorded as their session's agent: `agent:session:<sessionId>`.\n // Work item runs are created shared, so the session's own visibility decides.\n const sessionId = threadId.startsWith(SESSION_ACTOR_PREFIX)\n ? threadId.slice(SESSION_ACTOR_PREFIX.length)\n : undefined;\n result = (sessionId ? sessionVisible(sessionId) : threadVisible(threadId)).catch(() => false);\n threads.set(threadId, result);\n }\n return result;\n };\n\n return async (event: AuditEventRow): Promise<boolean> => {\n if (event.actorType === 'agent' && !(await agentVisible(event))) return false;\n for (const sessionId of sessionRefs(event)) {\n if (!(await sessionVisible(sessionId))) return false;\n }\n return true;\n };\n}\n"],"mappings":"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"}
|
package/dist/tools/index.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { IntegrationTools } from '../integrations/base.js';
|
|
2
2
|
import type { FactoryApprovalToolDependencies } from './approval-tools.js';
|
|
3
|
+
import type { FactoryAuditToolDependencies } from './audit-events-tool.js';
|
|
3
4
|
import type { FactoryMessagingToolDependencies } from './messaging-tools.js';
|
|
4
5
|
import type { FactoryReadToolDependencies } from './read-tools.js';
|
|
5
6
|
import type { FactoryToolScope } from './scope.js';
|
|
@@ -9,7 +10,7 @@ export { FACTORY_TOOLS_WITHOUT_APPROVAL, applyFactoryToolPermissions } from './p
|
|
|
9
10
|
export { FACTORY_INTERACTIVE_KEY, resolveFactoryToolScope } from './scope.js';
|
|
10
11
|
export type { FactoryToolScope } from './scope.js';
|
|
11
12
|
/** Storage and services the Factory tools act through. */
|
|
12
|
-
export type FactoryToolDependencies = FactoryReadToolDependencies & FactoryWorkItemToolDependencies & FactoryMessagingToolDependencies & FactorySessionToolDependencies & FactoryApprovalToolDependencies;
|
|
13
|
+
export type FactoryToolDependencies = FactoryReadToolDependencies & FactoryAuditToolDependencies & FactoryWorkItemToolDependencies & FactoryMessagingToolDependencies & FactorySessionToolDependencies & FactoryApprovalToolDependencies;
|
|
13
14
|
export interface CreateFactoryToolsOptions {
|
|
14
15
|
scope: FactoryToolScope;
|
|
15
16
|
deps: FactoryToolDependencies;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,GAC/D,+BAA+B,GAC/B,gCAAgC,GAChC,8BAA8B,GAC9B,+BAA+B,CAAC;AAElC,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,uBAAuB,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,yBAAyB,GAAG,gBAAgB,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAE3E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,GAC/D,4BAA4B,GAC5B,+BAA+B,GAC/B,gCAAgC,GAChC,8BAA8B,GAC9B,+BAA+B,CAAC;AAElC,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,uBAAuB,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,yBAAyB,GAAG,gBAAgB,CAW/F"}
|
package/dist/tools/index.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { FACTORY_INTERACTIVE_KEY } from "../auth.js";
|
|
2
2
|
import { createFactoryApprovalTools } from "./approval-tools.js";
|
|
3
|
+
import { createAuditEventsTool } from "./audit-events-tool.js";
|
|
3
4
|
import { createFactoryMessagingTools } from "./messaging-tools.js";
|
|
4
5
|
import { createFactoryReadTools } from "./read-tools.js";
|
|
5
6
|
import { createFactorySessionTools } from "./session-tools.js";
|
|
@@ -24,6 +25,7 @@ function createFactoryTools({ scope, deps }) {
|
|
|
24
25
|
if (scope.kind !== "user") return messagingTools;
|
|
25
26
|
return {
|
|
26
27
|
...createFactoryReadTools(scope, deps),
|
|
28
|
+
factory_list_audit_events: createAuditEventsTool(scope, deps),
|
|
27
29
|
...messagingTools,
|
|
28
30
|
...createFactoryWorkItemTools(scope, deps),
|
|
29
31
|
...createFactorySessionTools(scope, deps),
|
package/dist/tools/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../../src/tools/index.ts"],"sourcesContent":["import type { IntegrationTools } from '../integrations/base.js';\nimport { createFactoryApprovalTools } from './approval-tools.js';\nimport type { FactoryApprovalToolDependencies } from './approval-tools.js';\nimport { createFactoryMessagingTools } from './messaging-tools.js';\nimport type { FactoryMessagingToolDependencies } from './messaging-tools.js';\nimport { createFactoryReadTools } from './read-tools.js';\nimport type { FactoryReadToolDependencies } from './read-tools.js';\nimport type { FactoryToolScope } from './scope.js';\nimport { createFactorySessionTools } from './session-tools.js';\nimport type { FactorySessionToolDependencies } from './session-tools.js';\nimport { createFactoryWorkItemTools } from './work-item-tools.js';\nimport type { FactoryWorkItemToolDependencies } from './work-item-tools.js';\n\nexport { FACTORY_TOOLS_WITHOUT_APPROVAL, applyFactoryToolPermissions } from './permissions.js';\nexport { FACTORY_INTERACTIVE_KEY, resolveFactoryToolScope } from './scope.js';\nexport type { FactoryToolScope } from './scope.js';\n\n/** Storage and services the Factory tools act through. */\nexport type FactoryToolDependencies = FactoryReadToolDependencies &\n FactoryWorkItemToolDependencies &\n FactoryMessagingToolDependencies &\n FactorySessionToolDependencies &\n FactoryApprovalToolDependencies;\n\nexport interface CreateFactoryToolsOptions {\n scope: FactoryToolScope;\n deps: FactoryToolDependencies;\n}\n\n/**\n * The Factory toolset for a resolved scope. Tools take scope and storage by\n * closure and never read the request context, so a non-session transport\n * (an MCP server) can mount the same set with a scope it resolved itself.\n *\n * Worker and side sessions only answer messages. User sessions get every tool\n * on every turn. Turns nobody signed in started (notification wakes, webhooks,\n * dispatcher notices) carry text other people wrote, so each tool limits what\n * it does on them itself: approvals, proposals and muting\n * side sessions need a person, moves run as an agent, model switches reach\n * only this session and its side sessions, and starts are side sessions only.\n */\nexport function createFactoryTools({ scope, deps }: CreateFactoryToolsOptions): IntegrationTools {\n const messagingTools = createFactoryMessagingTools(scope, deps);\n if (scope.kind !== 'user') return messagingTools;\n return {\n ...createFactoryReadTools(scope, deps),\n ...messagingTools,\n ...createFactoryWorkItemTools(scope, deps),\n ...createFactorySessionTools(scope, deps),\n ...createFactoryApprovalTools(scope, deps),\n };\n}\n"],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../../src/tools/index.ts"],"sourcesContent":["import type { IntegrationTools } from '../integrations/base.js';\nimport { createFactoryApprovalTools } from './approval-tools.js';\nimport type { FactoryApprovalToolDependencies } from './approval-tools.js';\nimport { createAuditEventsTool } from './audit-events-tool.js';\nimport type { FactoryAuditToolDependencies } from './audit-events-tool.js';\nimport { createFactoryMessagingTools } from './messaging-tools.js';\nimport type { FactoryMessagingToolDependencies } from './messaging-tools.js';\nimport { createFactoryReadTools } from './read-tools.js';\nimport type { FactoryReadToolDependencies } from './read-tools.js';\nimport type { FactoryToolScope } from './scope.js';\nimport { createFactorySessionTools } from './session-tools.js';\nimport type { FactorySessionToolDependencies } from './session-tools.js';\nimport { createFactoryWorkItemTools } from './work-item-tools.js';\nimport type { FactoryWorkItemToolDependencies } from './work-item-tools.js';\n\nexport { FACTORY_TOOLS_WITHOUT_APPROVAL, applyFactoryToolPermissions } from './permissions.js';\nexport { FACTORY_INTERACTIVE_KEY, resolveFactoryToolScope } from './scope.js';\nexport type { FactoryToolScope } from './scope.js';\n\n/** Storage and services the Factory tools act through. */\nexport type FactoryToolDependencies = FactoryReadToolDependencies &\n FactoryAuditToolDependencies &\n FactoryWorkItemToolDependencies &\n FactoryMessagingToolDependencies &\n FactorySessionToolDependencies &\n FactoryApprovalToolDependencies;\n\nexport interface CreateFactoryToolsOptions {\n scope: FactoryToolScope;\n deps: FactoryToolDependencies;\n}\n\n/**\n * The Factory toolset for a resolved scope. Tools take scope and storage by\n * closure and never read the request context, so a non-session transport\n * (an MCP server) can mount the same set with a scope it resolved itself.\n *\n * Worker and side sessions only answer messages. User sessions get every tool\n * on every turn. Turns nobody signed in started (notification wakes, webhooks,\n * dispatcher notices) carry text other people wrote, so each tool limits what\n * it does on them itself: approvals, proposals and muting\n * side sessions need a person, moves run as an agent, model switches reach\n * only this session and its side sessions, and starts are side sessions only.\n */\nexport function createFactoryTools({ scope, deps }: CreateFactoryToolsOptions): IntegrationTools {\n const messagingTools = createFactoryMessagingTools(scope, deps);\n if (scope.kind !== 'user') return messagingTools;\n return {\n ...createFactoryReadTools(scope, deps),\n factory_list_audit_events: createAuditEventsTool(scope, deps),\n ...messagingTools,\n ...createFactoryWorkItemTools(scope, deps),\n ...createFactorySessionTools(scope, deps),\n ...createFactoryApprovalTools(scope, deps),\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAgB,mBAAmB,EAAE,OAAO,QAAqD;CAC/F,MAAM,iBAAiB,4BAA4B,OAAO,IAAI;CAC9D,IAAI,MAAM,SAAS,QAAQ,OAAO;CAClC,OAAO;EACL,GAAG,uBAAuB,OAAO,IAAI;EACrC,2BAA2B,sBAAsB,OAAO,IAAI;EAC5D,GAAG;EACH,GAAG,2BAA2B,OAAO,IAAI;EACzC,GAAG,0BAA0B,OAAO,IAAI;EACxC,GAAG,2BAA2B,OAAO,IAAI;CAC3C;AACF"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/tools/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEvF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,
|
|
1
|
+
{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/tools/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEvF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAuB3D,CAAC;AAEF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE;QAAE,KAAK,IAAI,MAAM,CAAA;KAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,IAAI,eAAe,CAAC;QAC5B,UAAU,CAAC,IAAI,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,gBAAgB,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACjF,CAAC;CACH;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,CAAC;CAC9D;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,6BAA6B,EACtC,EAAE,QAAQ,EAAE,EAAE,kCAAkC,EAChD,SAAS,GAAE,SAAS,MAAM,EAAmC,GAC5D,OAAO,CAAC,IAAI,CAAC,CASf"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"permissions.js","names":[],"sources":["../../src/tools/permissions.ts"],"sourcesContent":["import type { PermissionPolicy, PermissionRules } from '@mastra/core/agent-controller';\n\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\n\n/**\n * Factory tools that run without asking. Factory tools fall into the SDK's\n * `mcp` category, whose default policy is `ask`, so each of these needs an\n * explicit per-session `allow`.\n */\nexport const FACTORY_TOOLS_WITHOUT_APPROVAL: readonly string[] = [\n 'factory_list_work_items',\n 'factory_inspect_work_item',\n 'factory_list_attention',\n 'factory_create_work_item',\n 'factory_update_work_item',\n 'factory_transition_work_item',\n 'factory_retry_decision',\n 'factory_dismiss_decision',\n 'factory_resolve_proposal',\n 'factory_subscribe_work_item',\n 'factory_unsubscribe_work_item',\n 'factory_signal_session',\n 'factory_message_origin',\n 'factory_list_side_sessions',\n 'factory_subscribe_session',\n 'factory_unsubscribe_session',\n 'factory_start_session',\n 'factory_answer_approval',\n 'factory_switch_session_model',\n 'factory_recreate_sandbox',\n 'factory_sandbox_port_url',\n];\n\nexport interface FactoryToolPermissionsSession {\n readonly identity: { getId(): string };\n readonly permissions: {\n getRules(): PermissionRules;\n setForTool(args: { toolName: string; policy: PermissionPolicy }): Promise<void>;\n };\n}\n\nexport interface FactoryToolPermissionsDependencies {\n sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;\n}\n\n/**\n * Allow the no-approval Factory tools on a newly created Factory session.\n * This only sets policy; which tools a turn actually gets is decided by the\n * tool scope. A person's own choices win: a per-tool policy is never\n * overwritten, and an explicit `mcp` category policy leaves everything alone.\n */\nexport async function applyFactoryToolPermissions(\n session: FactoryToolPermissionsSession,\n { sessions }: FactoryToolPermissionsDependencies,\n toolNames: readonly string[] = FACTORY_TOOLS_WITHOUT_APPROVAL,\n): Promise<void> {\n const row = await sessions.getBySessionId(session.identity.getId());\n if (!row?.factoryProjectId) return;\n const rules = session.permissions.getRules();\n if (rules.categories.mcp !== undefined) return;\n for (const toolName of toolNames) {\n if (session.permissions.getRules().tools[toolName] !== undefined) continue;\n await session.permissions.setForTool({ toolName, policy: 'allow' });\n }\n}\n"],"mappings":";;;;;;AASA,MAAa,iCAAoD;CAC/D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;AAoBA,eAAsB,4BACpB,SACA,EAAE,YACF,YAA+B,gCAChB;CAEf,IAAI,EAAC,MADa,SAAS,eAAe,QAAQ,SAAS,MAAM,CAAC,EAAA,EACxD,kBAAkB;CAE5B,IADc,QAAQ,YAAY,SAC1B,CAAC,CAAC,WAAW,QAAQ,KAAA,GAAW;CACxC,KAAK,MAAM,YAAY,WAAW;EAChC,IAAI,QAAQ,YAAY,SAAS,CAAC,CAAC,MAAM,cAAc,KAAA,GAAW;EAClE,MAAM,QAAQ,YAAY,WAAW;GAAE;GAAU,QAAQ;EAAQ,CAAC;CACpE;AACF"}
|
|
1
|
+
{"version":3,"file":"permissions.js","names":[],"sources":["../../src/tools/permissions.ts"],"sourcesContent":["import type { PermissionPolicy, PermissionRules } from '@mastra/core/agent-controller';\n\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\n\n/**\n * Factory tools that run without asking. Factory tools fall into the SDK's\n * `mcp` category, whose default policy is `ask`, so each of these needs an\n * explicit per-session `allow`.\n */\nexport const FACTORY_TOOLS_WITHOUT_APPROVAL: readonly string[] = [\n 'factory_list_work_items',\n 'factory_inspect_work_item',\n 'factory_list_attention',\n 'factory_list_audit_events',\n 'factory_create_work_item',\n 'factory_update_work_item',\n 'factory_transition_work_item',\n 'factory_retry_decision',\n 'factory_dismiss_decision',\n 'factory_resolve_proposal',\n 'factory_subscribe_work_item',\n 'factory_unsubscribe_work_item',\n 'factory_signal_session',\n 'factory_message_origin',\n 'factory_list_side_sessions',\n 'factory_subscribe_session',\n 'factory_unsubscribe_session',\n 'factory_start_session',\n 'factory_answer_approval',\n 'factory_switch_session_model',\n 'factory_recreate_sandbox',\n 'factory_sandbox_port_url',\n];\n\nexport interface FactoryToolPermissionsSession {\n readonly identity: { getId(): string };\n readonly permissions: {\n getRules(): PermissionRules;\n setForTool(args: { toolName: string; policy: PermissionPolicy }): Promise<void>;\n };\n}\n\nexport interface FactoryToolPermissionsDependencies {\n sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;\n}\n\n/**\n * Allow the no-approval Factory tools on a newly created Factory session.\n * This only sets policy; which tools a turn actually gets is decided by the\n * tool scope. A person's own choices win: a per-tool policy is never\n * overwritten, and an explicit `mcp` category policy leaves everything alone.\n */\nexport async function applyFactoryToolPermissions(\n session: FactoryToolPermissionsSession,\n { sessions }: FactoryToolPermissionsDependencies,\n toolNames: readonly string[] = FACTORY_TOOLS_WITHOUT_APPROVAL,\n): Promise<void> {\n const row = await sessions.getBySessionId(session.identity.getId());\n if (!row?.factoryProjectId) return;\n const rules = session.permissions.getRules();\n if (rules.categories.mcp !== undefined) return;\n for (const toolName of toolNames) {\n if (session.permissions.getRules().tools[toolName] !== undefined) continue;\n await session.permissions.setForTool({ toolName, policy: 'allow' });\n }\n}\n"],"mappings":";;;;;;AASA,MAAa,iCAAoD;CAC/D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;AAoBA,eAAsB,4BACpB,SACA,EAAE,YACF,YAA+B,gCAChB;CAEf,IAAI,EAAC,MADa,SAAS,eAAe,QAAQ,SAAS,MAAM,CAAC,EAAA,EACxD,kBAAkB;CAE5B,IADc,QAAQ,YAAY,SAC1B,CAAC,CAAC,WAAW,QAAQ,KAAA,GAAW;CACxC,KAAK,MAAM,YAAY,WAAW;EAChC,IAAI,QAAQ,YAAY,SAAS,CAAC,CAAC,MAAM,cAAc,KAAA,GAAW;EAClE,MAAM,QAAQ,YAAY,WAAW;GAAE;GAAU,QAAQ;EAAQ,CAAC;CACpE;AACF"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/factory",
|
|
3
|
-
"version": "0.28.0-alpha.
|
|
3
|
+
"version": "0.28.0-alpha.14",
|
|
4
4
|
"description": "Mastra Software Factory module: the server core behind the Mastra Software Factory — storage domains, integrations, and surfaces for agent-powered software delivery",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"publishConfig": {
|
|
@@ -58,14 +58,14 @@
|
|
|
58
58
|
"hono": "^4.13.13",
|
|
59
59
|
"posthog-node": "^5.57.1",
|
|
60
60
|
"zod": "^4.6.7",
|
|
61
|
-
"@mastra/auth-studio": "1.4.0-alpha.1",
|
|
62
|
-
"@mastra/auth-workos": "1.6.8",
|
|
63
|
-
"@mastra/code-sdk": "1.19.0-alpha.13",
|
|
64
61
|
"@mastra/connect": "1.4.0-alpha.5",
|
|
65
|
-
"@mastra/core": "1.83.0-alpha.
|
|
62
|
+
"@mastra/core": "1.83.0-alpha.12",
|
|
66
63
|
"@mastra/mcp": "2.9.0-alpha.4",
|
|
67
64
|
"@mastra/platform-workspace": "1.13.0-alpha.1",
|
|
68
|
-
"@mastra/
|
|
65
|
+
"@mastra/code-sdk": "1.19.0-alpha.14",
|
|
66
|
+
"@mastra/slack": "1.9.0-alpha.0",
|
|
67
|
+
"@mastra/auth-studio": "1.4.0-alpha.1",
|
|
68
|
+
"@mastra/auth-workos": "1.6.8"
|
|
69
69
|
},
|
|
70
70
|
"devDependencies": {
|
|
71
71
|
"@types/node": "22.19.15",
|
|
@@ -76,10 +76,10 @@
|
|
|
76
76
|
"@internal/lint": "0.0.148",
|
|
77
77
|
"@internal/types-builder": "0.0.123",
|
|
78
78
|
"@internal/workspace": "0.0.20",
|
|
79
|
-
"@mastra/deployer": "1.83.0-alpha.
|
|
79
|
+
"@mastra/deployer": "1.83.0-alpha.12",
|
|
80
80
|
"@mastra/libsql": "1.30.0-alpha.3",
|
|
81
|
-
"@mastra/pg": "1.36.0-alpha.
|
|
82
|
-
"@mastra/server": "1.83.0-alpha.
|
|
81
|
+
"@mastra/pg": "1.36.0-alpha.6",
|
|
82
|
+
"@mastra/server": "1.83.0-alpha.12"
|
|
83
83
|
},
|
|
84
84
|
"engines": {
|
|
85
85
|
"node": ">=22.19.0"
|