@mastra/factory 0.26.0 → 0.27.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.
Files changed (41) hide show
  1. package/README.md +10 -0
  2. package/dist/factory.d.ts.map +1 -1
  3. package/dist/factory.js +7 -3
  4. package/dist/factory.js.map +1 -1
  5. package/dist/integrations/gitlab/default-rules.d.ts +1 -1
  6. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  7. package/dist/routes/contracts.d.ts +54 -1
  8. package/dist/routes/contracts.d.ts.map +1 -1
  9. package/dist/routes/contracts.js +54 -1
  10. package/dist/routes/contracts.js.map +1 -1
  11. package/dist/routes/knowledge.d.ts +12 -228
  12. package/dist/routes/knowledge.d.ts.map +1 -1
  13. package/dist/routes/knowledge.js +207 -1045
  14. package/dist/routes/knowledge.js.map +1 -1
  15. package/dist/routes/skills.d.ts +9 -0
  16. package/dist/routes/skills.d.ts.map +1 -1
  17. package/dist/routes/skills.js +145 -4
  18. package/dist/routes/skills.js.map +1 -1
  19. package/dist/routes/surface.d.ts +2 -0
  20. package/dist/routes/surface.d.ts.map +1 -1
  21. package/dist/routes/surface.js +7 -5
  22. package/dist/routes/surface.js.map +1 -1
  23. package/dist/session/org-seed.d.ts +1 -1
  24. package/dist/session/org-seed.js.map +1 -1
  25. package/dist/skills/catalog.d.ts +28 -3
  26. package/dist/skills/catalog.d.ts.map +1 -1
  27. package/dist/skills/catalog.js +51 -8
  28. package/dist/skills/catalog.js.map +1 -1
  29. package/dist/storage/domains/audit/actions.d.ts +1 -0
  30. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  31. package/dist/storage/domains/audit/actions.js +2 -1
  32. package/dist/storage/domains/audit/actions.js.map +1 -1
  33. package/dist/storage/domains/skill-overrides/base.d.ts +56 -0
  34. package/dist/storage/domains/skill-overrides/base.d.ts.map +1 -0
  35. package/dist/storage/domains/skill-overrides/base.js +157 -0
  36. package/dist/storage/domains/skill-overrides/base.js.map +1 -0
  37. package/dist/workspace.d.ts +13 -1
  38. package/dist/workspace.d.ts.map +1 -1
  39. package/dist/workspace.js +94 -17
  40. package/dist/workspace.js.map +1 -1
  41. package/package.json +8 -8
@@ -0,0 +1,56 @@
1
+ import { FactoryStorageDomain } from '@mastra/core/storage';
2
+ import type { CollectionSchema } from '@mastra/core/storage';
3
+ /** A project's edited copy of one Factory skill's SKILL.md. */
4
+ export interface SkillOverrideRecord {
5
+ orgId: string;
6
+ projectId: string;
7
+ skillName: string;
8
+ /** The full edited SKILL.md, frontmatter included. */
9
+ content: string;
10
+ /** sha256 of the original SKILL.md the edit was made against. */
11
+ baseHash: string;
12
+ updatedBy: string;
13
+ updatedAt: Date;
14
+ }
15
+ /** Every override of one project, read at one revision. */
16
+ export interface SkillOverrideSnapshot {
17
+ revision: number;
18
+ overrides: SkillOverrideRecord[];
19
+ }
20
+ interface ProjectScope {
21
+ orgId: string;
22
+ projectId: string;
23
+ }
24
+ interface SkillScope extends ProjectScope {
25
+ skillName: string;
26
+ }
27
+ export declare const SKILL_OVERRIDES_SCHEMA: CollectionSchema;
28
+ /**
29
+ * One row per project whose `revision` is incremented in the same transaction as every save and
30
+ * revert, so skill sources can tell an unchanged override set from one indexed row read.
31
+ */
32
+ export declare const SKILL_OVERRIDE_REVISIONS_SCHEMA: CollectionSchema;
33
+ export declare class SkillOverridesStorage extends FactoryStorageDomain {
34
+ #private;
35
+ constructor();
36
+ init(): Promise<void>;
37
+ dangerouslyClearAll(): Promise<void>;
38
+ /** 0 until the project's first save. */
39
+ revision(scope: ProjectScope): Promise<number>;
40
+ list(scope: ProjectScope): Promise<SkillOverrideRecord[]>;
41
+ /**
42
+ * Reads the revision before the rows, so a write landing in between pairs newer rows with an
43
+ * older revision: the caller re-reads at the next check instead of caching stale rows as current.
44
+ */
45
+ snapshot(scope: ProjectScope): Promise<SkillOverrideSnapshot>;
46
+ get({ skillName, ...scope }: SkillScope): Promise<SkillOverrideRecord | null>;
47
+ upsert({ content, baseHash, updatedBy, skillName, ...scope }: SkillScope & {
48
+ content: string;
49
+ baseHash: string;
50
+ updatedBy: string;
51
+ }): Promise<SkillOverrideRecord>;
52
+ /** False when the skill had no override; the revision only moves when a row was removed. */
53
+ delete({ skillName, ...scope }: SkillScope): Promise<boolean>;
54
+ }
55
+ export {};
56
+ //# sourceMappingURL=base.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/skill-overrides/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,sBAAsB,CAAC;AAEhF,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,UAAW,SAAQ,YAAY;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,sBAAsB,EAAE,gBAepC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,gBAU7C,CAAC;AAmCF,qBAAa,qBAAsB,SAAQ,oBAAoB;;IAC7D,cAEC;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAEK,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGzC;IAMD,wCAAwC;IAClC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnD;IAEK,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAK9D;IAED;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAGlE;IAEK,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAMlF;IAEK,MAAM,CAAC,EACX,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,GAAG,KAAK,EACT,EAAE,UAAU,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkBtG;IAED,4FAA4F;IACtF,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAYlE;CAwBF"}
@@ -0,0 +1,157 @@
1
+ import { FactoryStorageDomain } from "@mastra/core/storage";
2
+ // src/storage/domains/skill-overrides/base.ts
3
+ const SKILL_OVERRIDES_SCHEMA = {
4
+ name: "factory_skill_overrides",
5
+ columns: {
6
+ id: { type: "uuid-pk" },
7
+ org_id: { type: "text" },
8
+ factory_project_id: { type: "text" },
9
+ skill_name: { type: "text" },
10
+ content: { type: "text" },
11
+ base_hash: { type: "text" },
12
+ updated_by: { type: "text" },
13
+ updated_at: { type: "timestamp" }
14
+ },
15
+ uniqueIndexes: [{
16
+ name: "factory_skill_overrides_scope_key",
17
+ columns: [
18
+ "org_id",
19
+ "factory_project_id",
20
+ "skill_name"
21
+ ]
22
+ }]
23
+ };
24
+ /**
25
+ * One row per project whose `revision` is incremented in the same transaction as every save and
26
+ * revert, so skill sources can tell an unchanged override set from one indexed row read.
27
+ */
28
+ const SKILL_OVERRIDE_REVISIONS_SCHEMA = {
29
+ name: "factory_skill_override_revisions",
30
+ columns: {
31
+ id: { type: "uuid-pk" },
32
+ org_id: { type: "text" },
33
+ factory_project_id: { type: "text" },
34
+ revision: {
35
+ type: "integer",
36
+ default: 0
37
+ },
38
+ updated_at: { type: "timestamp" }
39
+ },
40
+ uniqueIndexes: [{
41
+ name: "factory_skill_override_revisions_scope_key",
42
+ columns: ["org_id", "factory_project_id"]
43
+ }]
44
+ };
45
+ function toRecord(row) {
46
+ return {
47
+ orgId: row.org_id,
48
+ projectId: row.factory_project_id,
49
+ skillName: row.skill_name,
50
+ content: row.content,
51
+ baseHash: row.base_hash,
52
+ updatedBy: row.updated_by,
53
+ updatedAt: row.updated_at
54
+ };
55
+ }
56
+ const projectWhere = ({ orgId, projectId }) => ({
57
+ org_id: orgId,
58
+ factory_project_id: projectId
59
+ });
60
+ var SkillOverridesStorage = class extends FactoryStorageDomain {
61
+ constructor() {
62
+ super("skill-overrides");
63
+ }
64
+ async init() {
65
+ await this.ensureCollections([SKILL_OVERRIDES_SCHEMA, SKILL_OVERRIDE_REVISIONS_SCHEMA]);
66
+ }
67
+ async dangerouslyClearAll() {
68
+ await this.ops.deleteMany("factory_skill_overrides", {});
69
+ await this.ops.deleteMany("factory_skill_override_revisions", {});
70
+ }
71
+ get #db() {
72
+ return this.ops;
73
+ }
74
+ /** 0 until the project's first save. */
75
+ async revision(scope) {
76
+ return (await this.#db.findOne("factory_skill_override_revisions", projectWhere(scope)))?.revision ?? 0;
77
+ }
78
+ async list(scope) {
79
+ return (await this.#db.findMany("factory_skill_overrides", projectWhere(scope), { orderBy: [["skill_name", "asc"]] })).map(toRecord);
80
+ }
81
+ /**
82
+ * Reads the revision before the rows, so a write landing in between pairs newer rows with an
83
+ * older revision: the caller re-reads at the next check instead of caching stale rows as current.
84
+ */
85
+ async snapshot(scope) {
86
+ return {
87
+ revision: await this.revision(scope),
88
+ overrides: await this.list(scope)
89
+ };
90
+ }
91
+ async get({ skillName, ...scope }) {
92
+ const row = await this.#db.findOne("factory_skill_overrides", {
93
+ ...projectWhere(scope),
94
+ skill_name: skillName
95
+ });
96
+ return row ? toRecord(row) : null;
97
+ }
98
+ async upsert({ content, baseHash, updatedBy, skillName, ...scope }) {
99
+ await this.#ensureRevisionRow(scope);
100
+ return this.storage.withTransaction(async (ops) => {
101
+ const now = await this.#bumpRevision(ops, scope);
102
+ return toRecord(await ops.upsertOne("factory_skill_overrides", [
103
+ "org_id",
104
+ "factory_project_id",
105
+ "skill_name"
106
+ ], {
107
+ ...projectWhere(scope),
108
+ skill_name: skillName,
109
+ content,
110
+ base_hash: baseHash,
111
+ updated_by: updatedBy,
112
+ updated_at: now
113
+ }));
114
+ });
115
+ }
116
+ /** False when the skill had no override; the revision only moves when a row was removed. */
117
+ async delete({ skillName, ...scope }) {
118
+ await this.#ensureRevisionRow(scope);
119
+ return this.storage.withTransaction(async (ops) => {
120
+ let deleted = false;
121
+ await ops.updateAtomic("factory_skill_override_revisions", projectWhere(scope), async (row) => {
122
+ deleted = await ops.deleteMany("factory_skill_overrides", {
123
+ ...projectWhere(scope),
124
+ skill_name: skillName
125
+ }) > 0;
126
+ return deleted ? {
127
+ revision: row.revision + 1,
128
+ updated_at: /* @__PURE__ */ new Date()
129
+ } : null;
130
+ });
131
+ return deleted;
132
+ });
133
+ }
134
+ /**
135
+ * Created outside the write transaction: on Postgres a lost insert race would abort the
136
+ * transaction, while `upsertOne` here retries it as an update.
137
+ */
138
+ async #ensureRevisionRow(scope) {
139
+ if (await this.#db.findOne("factory_skill_override_revisions", projectWhere(scope))) return;
140
+ await this.#db.upsertOne("factory_skill_override_revisions", ["org_id", "factory_project_id"], {
141
+ ...projectWhere(scope),
142
+ updated_at: /* @__PURE__ */ new Date()
143
+ });
144
+ }
145
+ /** Locks the project's revision row, so concurrent writers to one project serialize behind it. */
146
+ async #bumpRevision(ops, scope) {
147
+ const now = /* @__PURE__ */ new Date();
148
+ if (!await ops.updateAtomic("factory_skill_override_revisions", projectWhere(scope), (row) => ({
149
+ revision: row.revision + 1,
150
+ updated_at: now
151
+ }))) throw new Error("Skill override revision row is missing");
152
+ return now;
153
+ }
154
+ };
155
+ export { SKILL_OVERRIDES_SCHEMA, SKILL_OVERRIDE_REVISIONS_SCHEMA, SkillOverridesStorage };
156
+
157
+ //# sourceMappingURL=base.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base.js","names":[],"sources":["../../../../src/storage/domains/skill-overrides/base.ts"],"sourcesContent":["import { FactoryStorageDomain } from '@mastra/core/storage';\nimport type { CollectionSchema, FactoryStorageOps } from '@mastra/core/storage';\n\n/** A project's edited copy of one Factory skill's SKILL.md. */\nexport interface SkillOverrideRecord {\n orgId: string;\n projectId: string;\n skillName: string;\n /** The full edited SKILL.md, frontmatter included. */\n content: string;\n /** sha256 of the original SKILL.md the edit was made against. */\n baseHash: string;\n updatedBy: string;\n updatedAt: Date;\n}\n\n/** Every override of one project, read at one revision. */\nexport interface SkillOverrideSnapshot {\n revision: number;\n overrides: SkillOverrideRecord[];\n}\n\ninterface ProjectScope {\n orgId: string;\n projectId: string;\n}\n\ninterface SkillScope extends ProjectScope {\n skillName: string;\n}\n\nexport const SKILL_OVERRIDES_SCHEMA: CollectionSchema = {\n name: 'factory_skill_overrides',\n columns: {\n id: { type: 'uuid-pk' },\n org_id: { type: 'text' },\n factory_project_id: { type: 'text' },\n skill_name: { type: 'text' },\n content: { type: 'text' },\n base_hash: { type: 'text' },\n updated_by: { type: 'text' },\n updated_at: { type: 'timestamp' },\n },\n uniqueIndexes: [\n { name: 'factory_skill_overrides_scope_key', columns: ['org_id', 'factory_project_id', 'skill_name'] },\n ],\n};\n\n/**\n * One row per project whose `revision` is incremented in the same transaction as every save and\n * revert, so skill sources can tell an unchanged override set from one indexed row read.\n */\nexport const SKILL_OVERRIDE_REVISIONS_SCHEMA: CollectionSchema = {\n name: 'factory_skill_override_revisions',\n columns: {\n id: { type: 'uuid-pk' },\n org_id: { type: 'text' },\n factory_project_id: { type: 'text' },\n revision: { type: 'integer', default: 0 },\n updated_at: { type: 'timestamp' },\n },\n uniqueIndexes: [{ name: 'factory_skill_override_revisions_scope_key', columns: ['org_id', 'factory_project_id'] }],\n};\n\ninterface SkillOverrideDbRow extends Record<string, unknown> {\n id: string;\n org_id: string;\n factory_project_id: string;\n skill_name: string;\n content: string;\n base_hash: string;\n updated_by: string;\n updated_at: Date;\n}\n\ninterface RevisionDbRow extends Record<string, unknown> {\n id: string;\n org_id: string;\n factory_project_id: string;\n revision: number;\n updated_at: Date;\n}\n\nfunction toRecord(row: SkillOverrideDbRow): SkillOverrideRecord {\n return {\n orgId: row.org_id,\n projectId: row.factory_project_id,\n skillName: row.skill_name,\n content: row.content,\n baseHash: row.base_hash,\n updatedBy: row.updated_by,\n updatedAt: row.updated_at,\n };\n}\n\nconst projectWhere = ({ orgId, projectId }: ProjectScope) => ({ org_id: orgId, factory_project_id: projectId });\n\nexport class SkillOverridesStorage extends FactoryStorageDomain {\n constructor() {\n super('skill-overrides');\n }\n\n async init(): Promise<void> {\n await this.ensureCollections([SKILL_OVERRIDES_SCHEMA, SKILL_OVERRIDE_REVISIONS_SCHEMA]);\n }\n\n async dangerouslyClearAll(): Promise<void> {\n await this.ops.deleteMany('factory_skill_overrides', {});\n await this.ops.deleteMany('factory_skill_override_revisions', {});\n }\n\n get #db(): FactoryStorageOps {\n return this.ops;\n }\n\n /** 0 until the project's first save. */\n async revision(scope: ProjectScope): Promise<number> {\n const row = await this.#db.findOne<RevisionDbRow>('factory_skill_override_revisions', projectWhere(scope));\n return row?.revision ?? 0;\n }\n\n async list(scope: ProjectScope): Promise<SkillOverrideRecord[]> {\n const rows = await this.#db.findMany<SkillOverrideDbRow>('factory_skill_overrides', projectWhere(scope), {\n orderBy: [['skill_name', 'asc']],\n });\n return rows.map(toRecord);\n }\n\n /**\n * Reads the revision before the rows, so a write landing in between pairs newer rows with an\n * older revision: the caller re-reads at the next check instead of caching stale rows as current.\n */\n async snapshot(scope: ProjectScope): Promise<SkillOverrideSnapshot> {\n const revision = await this.revision(scope);\n return { revision, overrides: await this.list(scope) };\n }\n\n async get({ skillName, ...scope }: SkillScope): Promise<SkillOverrideRecord | null> {\n const row = await this.#db.findOne<SkillOverrideDbRow>('factory_skill_overrides', {\n ...projectWhere(scope),\n skill_name: skillName,\n });\n return row ? toRecord(row) : null;\n }\n\n async upsert({\n content,\n baseHash,\n updatedBy,\n skillName,\n ...scope\n }: SkillScope & { content: string; baseHash: string; updatedBy: string }): Promise<SkillOverrideRecord> {\n await this.#ensureRevisionRow(scope);\n return this.storage.withTransaction(async ops => {\n const now = await this.#bumpRevision(ops, scope);\n const row = await ops.upsertOne<SkillOverrideDbRow>(\n 'factory_skill_overrides',\n ['org_id', 'factory_project_id', 'skill_name'],\n {\n ...projectWhere(scope),\n skill_name: skillName,\n content,\n base_hash: baseHash,\n updated_by: updatedBy,\n updated_at: now,\n },\n );\n return toRecord(row);\n });\n }\n\n /** False when the skill had no override; the revision only moves when a row was removed. */\n async delete({ skillName, ...scope }: SkillScope): Promise<boolean> {\n await this.#ensureRevisionRow(scope);\n return this.storage.withTransaction(async ops => {\n // Lock the revision row first so the delete and the bump commit together.\n let deleted = false;\n await ops.updateAtomic<RevisionDbRow>('factory_skill_override_revisions', projectWhere(scope), async row => {\n deleted =\n (await ops.deleteMany('factory_skill_overrides', { ...projectWhere(scope), skill_name: skillName })) > 0;\n return deleted ? { revision: row.revision + 1, updated_at: new Date() } : null;\n });\n return deleted;\n });\n }\n\n /**\n * Created outside the write transaction: on Postgres a lost insert race would abort the\n * transaction, while `upsertOne` here retries it as an update.\n */\n async #ensureRevisionRow(scope: ProjectScope): Promise<void> {\n if (await this.#db.findOne('factory_skill_override_revisions', projectWhere(scope))) return;\n await this.#db.upsertOne<RevisionDbRow>('factory_skill_override_revisions', ['org_id', 'factory_project_id'], {\n ...projectWhere(scope),\n updated_at: new Date(),\n });\n }\n\n /** Locks the project's revision row, so concurrent writers to one project serialize behind it. */\n async #bumpRevision(ops: FactoryStorageOps, scope: ProjectScope): Promise<Date> {\n const now = new Date();\n const row = await ops.updateAtomic<RevisionDbRow>('factory_skill_override_revisions', projectWhere(scope), row => ({\n revision: row.revision + 1,\n updated_at: now,\n }));\n if (!row) throw new Error('Skill override revision row is missing');\n return now;\n }\n}\n"],"mappings":"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"}
@@ -7,6 +7,7 @@ import type { RepositoryAccess, VersionControl } from './capabilities/version-co
7
7
  import type { GithubIntegration } from './integrations/github/integration.js';
8
8
  import type { FactorySandboxContext } from './sandbox/session-sandbox.js';
9
9
  import type { FactoryProject, FactoryProjectsStorage } from './storage/domains/projects/base.js';
10
+ import type { SkillOverridesStorage } from './storage/domains/skill-overrides/base.js';
10
11
  import type { SourceControlStorageHandle } from './storage/domains/source-control/base.js';
11
12
  import type { WorkItemsStorage } from './storage/domains/work-items/base.js';
12
13
  export declare const BUNDLED_FACTORY_SKILLS_PATH: string;
@@ -33,16 +34,25 @@ export declare const REVIEW_ONLY_FACTORY_SKILLS: Set<string>;
33
34
  * The source still checks the live binding, so this never widens access.
34
35
  */
35
36
  export declare function rescanFactorySkills(skills: NonNullable<Workspace['skills']>): Promise<void>;
37
+ /** A project's edited SKILL.md, served in place of the original's. */
38
+ export interface FactorySkillOverride {
39
+ content: string;
40
+ updatedAt: Date;
41
+ }
36
42
  export declare class FactorySkillSource implements SkillSource {
37
43
  #private;
38
44
  readonly fallback: SkillSource;
39
45
  /** Evaluated per call because a session's bound role changes across stages. */
40
46
  readonly isReviewSession: () => Promise<boolean>;
47
+ /** The session project's edited SKILL.md files by skill name; read per call so saves and reverts apply on the next scan. */
48
+ readonly skillOverrides: () => Promise<ReadonlyMap<string, FactorySkillOverride>>;
41
49
  constructor(fallback: SkillSource, fallbackSkillRoots: string[], localSkillsPath?: string | undefined,
42
50
  /** Evaluated per call because a session's bound role changes across stages. */
43
51
  isReviewSession?: () => Promise<boolean>,
44
52
  /** Skills passed as `MastraFactory({ skills })`; they win over local and bundled skills of the same name. */
45
- codeSkills?: readonly InlineSkill[]);
53
+ codeSkills?: readonly InlineSkill[],
54
+ /** The session project's edited SKILL.md files by skill name; read per call so saves and reverts apply on the next scan. */
55
+ skillOverrides?: () => Promise<ReadonlyMap<string, FactorySkillOverride>>);
46
56
  exists(skillPath: string): Promise<boolean>;
47
57
  stat(skillPath: string): Promise<SkillSourceStat>;
48
58
  readFile(skillPath: string): Promise<string | Buffer>;
@@ -85,6 +95,8 @@ export interface CreateWorkspaceFactoryOptions {
85
95
  workspaceRegistry?: FactoryWorkspaceRegistry;
86
96
  /** App skills from `MastraFactory({ skills })`, served on the Factory skill mount. */
87
97
  skills?: readonly InlineSkill[];
98
+ /** Per-project SKILL.md edits served over the Factory skills of each session's project. */
99
+ skillOverrides?: Pick<SkillOverridesStorage, 'ensureReady' | 'revision' | 'snapshot'>;
88
100
  }
89
101
  type WorkspaceUnregister = () => Promise<void> | void;
90
102
  /** Tracks dynamic Factory workspaces by persisted session id for retirement. */
@@ -1 +1 @@
1
- {"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"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"}
package/dist/workspace.js CHANGED
@@ -112,16 +112,19 @@ var CodeSkillSource = class {
112
112
  return this.#inline.readdir(this.#inlinePath(relativePath));
113
113
  }
114
114
  };
115
+ const NO_SKILL_OVERRIDES = /* @__PURE__ */ new Map();
115
116
  var FactorySkillSource = class {
116
117
  fallback;
117
118
  isReviewSession;
119
+ skillOverrides;
118
120
  #bundledSource = new LocalSkillSource({ basePath: BUNDLED_FACTORY_SKILLS_PATH });
119
121
  #localSource;
120
122
  #codeSource;
121
123
  #fallbackSkillRoots;
122
- constructor(fallback, fallbackSkillRoots, localSkillsPath = resolveLocalFactorySkillsPath(), isReviewSession = () => Promise.resolve(true), codeSkills = []) {
124
+ constructor(fallback, fallbackSkillRoots, localSkillsPath = resolveLocalFactorySkillsPath(), isReviewSession = () => Promise.resolve(true), codeSkills = [], skillOverrides = () => Promise.resolve(NO_SKILL_OVERRIDES)) {
123
125
  this.fallback = fallback;
124
126
  this.isReviewSession = isReviewSession;
127
+ this.skillOverrides = skillOverrides;
125
128
  this.#localSource = localSkillsPath ? new LocalSkillSource({ basePath: localSkillsPath }) : void 0;
126
129
  this.#codeSource = codeSkills.length > 0 ? new CodeSkillSource(codeSkills) : void 0;
127
130
  this.#fallbackSkillRoots = new Set(fallbackSkillRoots.map((skillPath) => path.normalize(skillPath)));
@@ -150,6 +153,16 @@ var FactorySkillSource = class {
150
153
  if (this.#localSource && await this.#localSource.exists(relativePath)) return this.#localSource;
151
154
  return this.#bundledSource;
152
155
  }
156
+ /**
157
+ * The edit replacing this path, when it is a skill's SKILL.md. Only the instructions are
158
+ * edited; the skill's other files still come from its layer. `exists` and `readdir` never
159
+ * consult edits, so an edit whose skill was removed from the app is never discovered.
160
+ */
161
+ async #overrideFor(relativePath) {
162
+ const [skillName, file, ...rest] = relativePath.split(path.sep);
163
+ if (!skillName || file !== "SKILL.md" || rest.length > 0) return void 0;
164
+ return (await this.skillOverrides()).get(skillName);
165
+ }
153
166
  async exists(skillPath) {
154
167
  if (!this.#isFactoryPath(skillPath)) return this.fallback.exists(skillPath);
155
168
  const relative = this.#factoryPath(skillPath);
@@ -162,12 +175,22 @@ var FactorySkillSource = class {
162
175
  if (!this.#isFactoryPath(skillPath)) return this.fallback.stat(skillPath);
163
176
  const relative = this.#factoryPath(skillPath);
164
177
  if (await this.#isHiddenReviewPath(relative)) throw skillSourceEnoent(skillPath);
178
+ const override = await this.#overrideFor(relative);
179
+ if (override) return {
180
+ name: "SKILL.md",
181
+ type: "file",
182
+ size: Buffer.byteLength(override.content),
183
+ createdAt: override.updatedAt,
184
+ modifiedAt: override.updatedAt
185
+ };
165
186
  return (await this.#layerFor(relative)).stat(relative);
166
187
  }
167
188
  async readFile(skillPath) {
168
189
  if (!this.#isFactoryPath(skillPath)) return this.fallback.readFile(skillPath);
169
190
  const relative = this.#factoryPath(skillPath);
170
191
  if (await this.#isHiddenReviewPath(relative)) throw skillSourceEnoent(skillPath);
192
+ const override = await this.#overrideFor(relative);
193
+ if (override) return override.content;
171
194
  return (await this.#layerFor(relative)).readFile(relative);
172
195
  }
173
196
  async readdir(skillPath) {
@@ -258,11 +281,11 @@ var UnmaterializedAwareSkillSource = class {
258
281
  return this.fallback.realpath ? this.fallback.realpath(skillPath) : Promise.resolve(skillPath);
259
282
  }
260
283
  };
261
- function createFactorySkillExtension(isReviewSession, codeSkills) {
284
+ function createFactorySkillExtension(isReviewSession, codeSkills, skillOverrides) {
262
285
  return {
263
286
  id: "web-factory",
264
287
  paths: [FACTORY_SKILLS_MOUNT],
265
- createSource: (fallback, fallbackSkillRoots) => new FactorySkillSource(fallback, fallbackSkillRoots, resolveLocalFactorySkillsPath(), isReviewSession, codeSkills)
288
+ createSource: (fallback, fallbackSkillRoots) => new FactorySkillSource(fallback, fallbackSkillRoots, resolveLocalFactorySkillsPath(), isReviewSession, codeSkills, skillOverrides)
266
289
  };
267
290
  }
268
291
  function isActiveReviewBinding(runBinding, orgId) {
@@ -404,7 +427,7 @@ function environmentSandboxContext(environment, options) {
404
427
  };
405
428
  }
406
429
  function createWorkspaceFactory(options = {}) {
407
- const { sandbox: sandboxConfig, github, projects, workItems } = options;
430
+ const { sandbox: sandboxConfig, github, projects, workItems, skillOverrides } = options;
408
431
  const sourceControls = options.sourceControls ?? (github ? [{
409
432
  id: github.id,
410
433
  versionControl: github.versionControl,
@@ -416,9 +439,12 @@ function createWorkspaceFactory(options = {}) {
416
439
  const githubTokenInjectors = /* @__PURE__ */ new Map();
417
440
  const githubTokenReconciliations = /* @__PURE__ */ new Map();
418
441
  const constructedWorkspaces = /* @__PURE__ */ new Map();
419
- const skillCacheReviewState = /* @__PURE__ */ new Map();
442
+ const skillCacheState = /* @__PURE__ */ new Map();
420
443
  const skillCacheRefreshes = /* @__PURE__ */ new Map();
421
444
  const skillReviewChecks = /* @__PURE__ */ new Map();
445
+ const skillOverrideStates = /* @__PURE__ */ new Map();
446
+ const UNREAD_SKILL_OVERRIDES = -1;
447
+ const skillCacheKey = (isReview, revision) => `${isReview ? "review" : "work"}@${revision}`;
422
448
  const resolve = async ({ requestContext, mastra, skillExtension }) => {
423
449
  const ctx = requestContext.get("controller");
424
450
  const resolvedSession = ctx?.sessionId ? await resolveSourceControlSession(sourceControls, ctx.sessionId) : null;
@@ -619,11 +645,51 @@ function createWorkspaceFactory(options = {}) {
619
645
  return false;
620
646
  }
621
647
  };
622
- const effectiveSkillExtension = skillExtension ?? createFactorySkillExtension(() => (skillReviewChecks.get(workspaceId) ?? isReviewSession)(), options.skills ?? []);
648
+ const effectiveSkillExtension = skillExtension ?? createFactorySkillExtension(() => (skillReviewChecks.get(workspaceId) ?? isReviewSession)(), options.skills ?? [], async () => (await (skillOverrideStates.get(workspaceId) ?? loadSkillOverrides())).overrides);
623
649
  const extensionId = effectiveSkillExtension ? `-${effectiveSkillExtension.id}` : "";
624
650
  const workspaceId = `${WORKSPACE_ID_PREFIX}-${projectRepository.id}-${session.id}${extensionId}`;
625
651
  const workspaceGeneration = workspaceRegistry.generation(session.sessionId);
626
652
  if (!skillExtension) skillReviewChecks.set(workspaceId, isReviewSession);
653
+ const overrideScope = skillOverrides && !skillExtension ? {
654
+ orgId: session.orgId,
655
+ projectId: connection.factoryProjectId
656
+ } : void 0;
657
+ const readOverrides = async (read) => {
658
+ try {
659
+ await skillOverrides.ensureReady();
660
+ return await read();
661
+ } catch (error) {
662
+ console.warn("[Mastra Factory] Could not read project skill edits; serving the original skills", {
663
+ factoryProjectId: connection.factoryProjectId,
664
+ error
665
+ });
666
+ return;
667
+ }
668
+ };
669
+ const currentOverrideRevision = async () => overrideScope ? await readOverrides(() => skillOverrides.revision(overrideScope)) ?? UNREAD_SKILL_OVERRIDES : 0;
670
+ const loadSkillOverrides = () => {
671
+ const loading = (async () => {
672
+ if (!overrideScope) return {
673
+ revision: 0,
674
+ overrides: NO_SKILL_OVERRIDES
675
+ };
676
+ const snapshot = await readOverrides(() => skillOverrides.snapshot(overrideScope));
677
+ if (!snapshot) return {
678
+ revision: UNREAD_SKILL_OVERRIDES,
679
+ overrides: NO_SKILL_OVERRIDES
680
+ };
681
+ return {
682
+ revision: snapshot.revision,
683
+ overrides: new Map(snapshot.overrides.map((o) => [o.skillName, {
684
+ content: o.content,
685
+ updatedAt: o.updatedAt
686
+ }]))
687
+ };
688
+ })();
689
+ skillOverrideStates.set(workspaceId, loading);
690
+ return loading;
691
+ };
692
+ const loadedOverrideRevision = async () => (await skillOverrideStates.get(workspaceId))?.revision;
627
693
  const configDir = DEFAULT_CONFIG_DIR;
628
694
  const getRepositoryAccess = () => sourceControl.versionControl.getRepositoryAccess({
629
695
  orgId: session.orgId,
@@ -737,7 +803,7 @@ function createWorkspaceFactory(options = {}) {
737
803
  if (evicted && githubTokenInjectors.get(workspaceId) === registered) {
738
804
  githubTokenInjectors.delete(workspaceId);
739
805
  constructedWorkspaces.delete(workspaceId);
740
- skillCacheReviewState.delete(workspaceId);
806
+ skillCacheState.delete(workspaceId);
741
807
  }
742
808
  }
743
809
  throw error;
@@ -760,31 +826,40 @@ function createWorkspaceFactory(options = {}) {
760
826
  if (!outside) return false;
761
827
  await outside;
762
828
  if (rescannedOutsideResolver.get(existing.skills) === outside) rescannedOutsideResolver.delete(existing.skills);
763
- skillCacheReviewState.delete(workspaceId);
829
+ skillCacheState.delete(workspaceId);
764
830
  return true;
765
831
  };
766
832
  await consumeOutsideRescan();
767
- let isReview = await isReviewSession();
833
+ const readTarget = async () => {
834
+ const [isReview, revision] = await Promise.all([isReviewSession(), currentOverrideRevision()]);
835
+ return {
836
+ isReview,
837
+ revision
838
+ };
839
+ };
840
+ let target = await readTarget();
768
841
  for (;;) {
769
842
  const inFlight = skillCacheRefreshes.get(workspaceId);
770
843
  if (inFlight) {
771
844
  await inFlight;
772
- isReview = await isReviewSession();
845
+ target = await readTarget();
773
846
  continue;
774
847
  }
775
848
  if (await consumeOutsideRescan()) {
776
- isReview = await isReviewSession();
849
+ target = await readTarget();
777
850
  continue;
778
851
  }
779
- if (skillCacheReviewState.get(workspaceId) === isReview) break;
780
- const target = isReview;
852
+ if (skillCacheState.get(workspaceId) === skillCacheKey(target.isReview, target.revision)) break;
853
+ const { isReview, revision } = target;
781
854
  const pending = (async () => {
855
+ const served = await loadedOverrideRevision() === revision ? revision : (await loadSkillOverrides()).revision;
782
856
  await existing.skills?.refresh();
783
- skillCacheReviewState.set(workspaceId, target);
857
+ skillCacheState.set(workspaceId, skillCacheKey(isReview, served));
858
+ return served;
784
859
  })().finally(() => skillCacheRefreshes.delete(workspaceId));
785
860
  skillCacheRefreshes.set(workspaceId, pending);
786
- await pending;
787
- isReview = await isReviewSession();
861
+ if (await pending === UNREAD_SKILL_OVERRIDES) break;
862
+ target = await readTarget();
788
863
  }
789
864
  }
790
865
  return reconcileRegisteredWorkspace(existing);
@@ -1054,11 +1129,13 @@ function createWorkspaceFactory(options = {}) {
1054
1129
  });
1055
1130
  mastra?.addWorkspace(workspace, workspaceId, { source: "mastra" });
1056
1131
  constructedWorkspaces.set(workspaceId, workspace);
1132
+ skillOverrideStates.delete(workspaceId);
1057
1133
  if (!await workspaceRegistry.register(session.sessionId, workspaceId, workspaceGeneration, async () => {
1058
1134
  githubTokenInjectors.delete(workspaceId);
1059
1135
  constructedWorkspaces.delete(workspaceId);
1060
- skillCacheReviewState.delete(workspaceId);
1136
+ skillCacheState.delete(workspaceId);
1061
1137
  skillReviewChecks.delete(workspaceId);
1138
+ skillOverrideStates.delete(workspaceId);
1062
1139
  evictSessionSandbox(session.id);
1063
1140
  clearSessionEnvironment(session.sessionId);
1064
1141
  await mastra?.removeWorkspace?.(workspaceId);