@mastra/factory 0.26.0-alpha.3 → 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 +12 -12
package/README.md CHANGED
@@ -484,6 +484,16 @@ When a card enters the phase and the skill does not exist, no run starts and the
484
484
 
485
485
  Settings › Skills shows the skill each custom phase runs, marks a phase whose skill is missing, marks built-in skills your app replaces, and lists your other skills under **App skills**.
486
486
 
487
+ ### Edit skills for one Factory
488
+
489
+ Organization admins can change the instructions of any skill for one Factory, without redeploying. Open Settings › Skills, choose **Edit** on a skill, change its description or instructions, and save. This works for built-in, folder and code skills, including the review skills. Other members can open a skill but not change it.
490
+
491
+ An edit applies to that Factory only and takes precedence over the code, folder and built-in versions of the skill. Sessions that start after the save use it; running sessions keep the version they started with. A skill name cannot change, and the saved `SKILL.md` must pass the same checks Factory uses when it loads skills, or the save is rejected. Review skills stay limited to review sessions when edited.
492
+
493
+ An edited skill shows an **Edited** badge. When the original changes after the edit, for example in a new release of `@mastra/factory` or of your app, the editor says so; the edit stays in place until you choose **Revert to original**. If the original skill is removed from your app, its edit stops applying.
494
+
495
+ Saves and reverts are recorded in the audit log as `factory.skill.updated` and `factory.skill.reverted`. The API is `PUT` and `DELETE` on `/web/factory/projects/:id/skills/:name`, and `GET /web/factory/skills?projectId=<id>` lists a Factory's skills with its edits.
496
+
487
497
  ### Execute a custom board
488
498
 
489
499
  Custom boards can create linked items, start working roles, transition through bound tools, and react to completed tool results. Board and phase identifiers contain 1–128 letters, digits, underscores, or hyphens and start with a letter or digit. Identifiers are case-sensitive and cannot contain surrounding whitespace.
@@ -1 +1 @@
1
- {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EAAiC,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAkB,yBAAyB,EAAoB,MAAM,wBAAwB,CAAC;AAa1G,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOvE,OAAO,KAAK,EAAE,kBAAkB,EAAgD,MAAM,wBAAwB,CAAC;AAE/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAclF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAgCxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AA6DtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC;;;;;;;OAOG;IACH,OAAO,EAAE,cAAc,CAAC;IACxB,iEAAiE;IACjE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC;IACjD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,aAAa,EAAE,CAAC;IACtC,mDAAmD;IACnD,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C;;;;;;;;OAQG;IACH,wBAAwB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,sGAAsG;QACtG,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;;;;WAMG;QACH,MAAM,CAAC,EAAE;YACP,uFAAuF;YACvF,KAAK,CAAC,EAAE,mBAAmB,CAAC;YAC5B;;;eAGG;YACH,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED,YAAY,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC3G,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkHD,qBAAa,aAAa;;IAuBxB,YAAY,MAAM,EAAE,mBAAmB,EAyBtC;IAED;;;;OAIG;IACH,IAAI,kBAAkB,IAAI,yBAAyB,GAAG,SAAS,CAI9D;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAskDnC;IAED;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB9B;IAED,oGAAoG;IAC9F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB9B;CACF"}
package/dist/factory.js CHANGED
@@ -86,6 +86,7 @@ import { CustomProvidersStorage } from "./storage/domains/custom-providers/base.
86
86
  import { FilesystemStorage } from "./storage/domains/filesystem/base.js";
87
87
  import { IntegrationStorage } from "./storage/domains/integrations/base.js";
88
88
  import { ModelDefaultsStorage } from "./storage/domains/model-defaults/base.js";
89
+ import { SkillOverridesStorage } from "./storage/domains/skill-overrides/base.js";
89
90
  import { createFactorySandboxTools } from "./tools/sandbox-tools.js";
90
91
  import { FactorySessionsStateProcessor } from "./tools/sessions-state-processor.js";
91
92
  import { RequestContext } from "@mastra/core/request-context";
@@ -331,6 +332,7 @@ var MastraFactory = class {
331
332
  const sourceControlStorage = storage.registerDomain(new SourceControlStorage());
332
333
  const channelIdentityStorage = storage.registerDomain(new ChannelIdentityStorage());
333
334
  const workItemCommentsStorage = storage.registerDomain(new WorkItemCommentsStorage());
335
+ const skillOverridesStorage = storage.registerDomain(new SkillOverridesStorage());
334
336
  const domains = {
335
337
  intake: intakeStorage,
336
338
  modelCredentials: modelCredentialsStorage,
@@ -342,7 +344,8 @@ var MastraFactory = class {
342
344
  queueHealth: queueHealthStorage,
343
345
  workItems: workItemsStorage,
344
346
  channelIdentity: channelIdentityStorage,
345
- comments: workItemCommentsStorage
347
+ comments: workItemCommentsStorage,
348
+ skillOverrides: skillOverridesStorage
346
349
  };
347
350
  const auditDomain = new AuditDomain({
348
351
  auth: routeAuth,
@@ -460,7 +463,7 @@ var MastraFactory = class {
460
463
  return false;
461
464
  }
462
465
  });
463
- const knowledgeEnabled = this.#config.knowledge !== void 0 || process.env.MASTRACODE_EXPERIMENTAL_SUBCONSCIOUS === "1";
466
+ const knowledgeEnabled = this.#config.knowledge !== void 0;
464
467
  const githubIntegration = integrations.find((integration) => integration.id === "github");
465
468
  const gitlabIntegration = integrations.find((integration) => integration.id === "gitlab" && integration.intake && integration.versionControl);
466
469
  const workItemsReady = storage.isDomainReady("work-items");
@@ -782,6 +785,7 @@ var MastraFactory = class {
782
785
  resolveDefaultThinkingLevel: ({ requestContext }) => resolveDefaultThinkingLevel(requestContext),
783
786
  workspace: createWorkspaceFactory({
784
787
  skills: this.#skills,
788
+ ...storage.isDomainReady("skill-overrides") ? { skillOverrides: skillOverridesStorage } : {},
785
789
  ...sandboxConfig ? { sandbox: sandboxConfig } : {},
786
790
  ...this.#config.sandboxStart ? { sandboxStart: this.#config.sandboxStart } : {},
787
791
  sourceControls: integrations.flatMap((integration) => integration.versionControl ? [{
@@ -892,7 +896,7 @@ var MastraFactory = class {
892
896
  storage: storage.getMastraStorage(),
893
897
  disableScoreStorage: this.#config.disableScoreStorage ?? true,
894
898
  ...mastraStorageBackend ? { storageBackend: mastraStorageBackend } : {},
895
- ...this.#config.knowledge ? { knowledge: this.#config.knowledge } : {},
899
+ knowledge: this.#config.knowledge ?? false,
896
900
  inputProcessors: async ({ requestContext }) => {
897
901
  const environmentProcessor = new FactoryEnvironmentStateProcessor();
898
902
  const sessionsProcessor = workItemsStorage && storage.isDomainReady("source-control") ? [new FactorySessionsStateProcessor({