@mastra/deployer 1.50.0-alpha.4 → 1.50.0

package/CHANGELOG.md

@@ -1,5 +1,154 @@
 # @mastra/deployer
 
+## 1.50.0
+
+### Minor Changes
+
+- Auto-construct a Mastra instance when no `index.ts` exists. If your `src/mastra` ([#18893](https://github.com/mastra-ai/mastra/pull/18893))
+  directory has file-based primitives but no entry file, `mastra dev` and
+  `mastra build` now build and run the project without any boilerplate — no
+  `new Mastra({...})` required.
+
+  ```
+  src/mastra/
+    storage.ts          // export default new LibSQLStore({ url: 'file:./mastra.db' })
+    observability.ts    // export default new Observability({ ... })
+    server.ts           // export default { port: 4111 }
+    studio.ts           // export default { ... }
+    agents/weather/     // file-based agent
+    workflows/report.ts // export default createWorkflow({ ... })
+  ```
+
+  ```sh
+  # No src/mastra/index.ts needed:
+  mastra dev
+  ```
+
+  Projects that already export a `mastra` instance from `index.ts` are unaffected.
+
+- Added file-system-routed observability singleton. Place an `observability.ts` file in your mastra directory that default-exports an `ObservabilityEntrypoint`, and it will be auto-discovered and registered when running `mastra dev` or `mastra build`. Code-registered observability takes precedence if both are present. ([#18887](https://github.com/mastra-ai/mastra/pull/18887))
+
+  ```ts
+  // src/mastra/observability.ts
+  import { Observability, MastraStorageExporter } from '@mastra/observability';
+
+  export default new Observability({
+    configs: { default: { serviceName: 'mastra', exporters: [new MastraStorageExporter()] } },
+  });
+  ```
+
+- Added file-system routed storage support. A `storage.ts` file under the mastra directory is now auto-discovered and registered during `mastra dev` / `mastra build`. The default export replaces the InMemoryStore fallback. Code-registered storage (passed to `new Mastra({storage})`) wins on collision. ([#18885](https://github.com/mastra-ai/mastra/pull/18885))
+
+  ```ts
+  // src/mastra/storage.ts
+  import { LibSQLStore } from '@mastra/libsql';
+
+  export default new LibSQLStore({ url: 'file:local.db' });
+  ```
+
+- Added file-system-routed workflows support. Workflows placed in `workflows/*.ts` under the mastra directory are now auto-discovered and registered during `mastra dev` / `mastra build`, matching the existing file-based agents convention. Code-registered workflows win on name collisions. ([#18883](https://github.com/mastra-ai/mastra/pull/18883))
+
+  ```ts
+  // src/mastra/workflows/onboarding.ts
+  import { createWorkflow } from '@mastra/core/workflows';
+
+  export default createWorkflow({ id: 'onboarding' /* ...steps */ });
+  ```
+
+- Added file-system routed server config singleton. Place a server.ts file in your mastra directory that default-exports a ServerConfig object, and it will be auto-discovered and registered when running mastra dev or mastra build. Code-registered server config takes precedence if both are present. ([#18888](https://github.com/mastra-ai/mastra/pull/18888))
+
+- Added file-system-routed agent processors. Place input and output processor files under `agents/<name>/processors/input/` and `agents/<name>/processors/output/`. Each file default-exports a processor, and they are auto-discovered and merged with config-defined processors when running `mastra dev` or `mastra build`. Config-defined processors run first, and a dynamic (function) `inputProcessors`/`outputProcessors` in `config.ts` takes precedence over discovered files. ([#18890](https://github.com/mastra-ai/mastra/pull/18890))
+
+  ```
+  src/mastra/agents/support/
+  ├── config.ts
+  ├── instructions.md
+  └── processors/
+      ├── input/
+      │   └── moderation.ts
+      └── output/
+          └── redact-pii.ts
+  ```
+
+  ```ts
+  // src/mastra/agents/support/processors/input/moderation.ts
+  import { ModerationProcessor } from '@mastra/core/processors';
+
+  export default new ModerationProcessor({ model: 'openai/gpt-5-nano' });
+  ```
+
+- Added file-system routed studio config singleton. Place a studio.ts file in your mastra directory that default-exports a StudioConfig object, and it will be auto-discovered and registered when running mastra dev or mastra build. Code-registered studio config takes precedence if both are present. ([#18889](https://github.com/mastra-ai/mastra/pull/18889))
+
+### Patch Changes
+
+- Fixed production builds so transitive workspace packages are bundled instead of being left as runtime imports. ([#18879](https://github.com/mastra-ai/mastra/pull/18879))
+
+- Fixed flat markdown skills crashing at runtime when missing a description in frontmatter. Discovery now fails early with a clear error pointing to the file and the Agent Skills spec. ([#18935](https://github.com/mastra-ai/mastra/pull/18935))
+
+- Fixed deployer output dependency versions for packages that do not export package.json. ([#18930](https://github.com/mastra-ai/mastra/pull/18930))
+
+- Fixed Studio HTML config injection so platform environment values are escaped before they are embedded in served or deployed `index.html` files. This keeps organization IDs, project IDs, observability endpoints and telemetry flags intact when they contain quotes, angle brackets, newlines or `$` sequences, and exposes `escapeStudioHtmlValue` from `@mastra/deployer/build` for the shared injection paths. ([#18812](https://github.com/mastra-ai/mastra/pull/18812))
+
+- Update `@mastra/core` peer dependency for the unified schedules API ([#18874](https://github.com/mastra-ai/mastra/pull/18874))
+
+- Hardened several string-parsing code paths against regular-expression denial of service (ReDoS). Path normalization, URL trimming, LLM token stripping, and observation parsing now use linear-time string scanning instead of regexes that could back-track polynomially on adversarial input. No behavior changes. ([#18801](https://github.com/mastra-ai/mastra/pull/18801))
+
+- Updated dependencies [[`b291760`](https://github.com/mastra-ai/mastra/commit/b291760df9d6c7e4fc72606c8f0a4af2cf6e946c), [`3ffb8b7`](https://github.com/mastra-ai/mastra/commit/3ffb8b720e90f5e6977129ec1f6707d43c2bebe0), [`6ef59fe`](https://github.com/mastra-ai/mastra/commit/6ef59fef1da52ed8da5fbb2a892c71cf4fb6c739), [`4039488`](https://github.com/mastra-ai/mastra/commit/403948898af7293198d9e8b3e7fb47f623c78b94), [`29b7ea6`](https://github.com/mastra-ai/mastra/commit/29b7ea64e72b5523d5bdcbd34ee03d2b854d54e1), [`b2c9d70`](https://github.com/mastra-ai/mastra/commit/b2c9d70757207fb01a9069549e69b6f0d73a6636), [`a51c63d`](https://github.com/mastra-ai/mastra/commit/a51c63d8ee639e4daeba2a0be093efa6a1b5e52f), [`252f63d`](https://github.com/mastra-ai/mastra/commit/252f63d8fec723955adb2202be2f01a75ad0e69c), [`5ea76a7`](https://github.com/mastra-ai/mastra/commit/5ea76a723d966c72da9aa3ab30ae20276e049765), [`6445560`](https://github.com/mastra-ai/mastra/commit/6445560327045d20b239585fc63fed72e9ce36ec), [`e2b9f33`](https://github.com/mastra-ai/mastra/commit/e2b9f33456fd638eca555f9466c6519d8d049666), [`10959d5`](https://github.com/mastra-ai/mastra/commit/10959d509d824f682d40ff96e05ee044aec3b0e5), [`c547a77`](https://github.com/mastra-ai/mastra/commit/c547a7729bdf64dfc2df29c965046c0712a18f10), [`a0085fa`](https://github.com/mastra-ai/mastra/commit/a0085fa0934e52c37c8c8b3d75a6bb5cd199af36), [`a2ba369`](https://github.com/mastra-ai/mastra/commit/a2ba369e796dfab610f41c6875965b488272fa55), [`d889c04`](https://github.com/mastra-ai/mastra/commit/d889c046468a97ba9e90007dbca729b4fecf5db0), [`ffc3c17`](https://github.com/mastra-ai/mastra/commit/ffc3c17274ea17c11aa6f73d3140649cd7fc8abc), [`81542c1`](https://github.com/mastra-ai/mastra/commit/81542c1835c35bc32f2ce4fa9136ee11993cd299), [`3908e53`](https://github.com/mastra-ai/mastra/commit/3908e53ce04bbea04f5e0c097d7aa298c35fabee), [`3908e53`](https://github.com/mastra-ai/mastra/commit/3908e53ce04bbea04f5e0c097d7aa298c35fabee), [`3908e53`](https://github.com/mastra-ai/mastra/commit/3908e53ce04bbea04f5e0c097d7aa298c35fabee), [`cb24ce7`](https://github.com/mastra-ai/mastra/commit/cb24ce76bd16ca88eb6a963f6277f8780e703029), [`02705fd`](https://github.com/mastra-ai/mastra/commit/02705fd2f5a9062210d64ea061adeeb10dc9452e), [`ae51e81`](https://github.com/mastra-ai/mastra/commit/ae51e818825582d42500338dfc1929a082eff0ba), [`6f304ef`](https://github.com/mastra-ai/mastra/commit/6f304ef319e99725e884bdb8d3193c001b6e5964), [`5f9858f`](https://github.com/mastra-ai/mastra/commit/5f9858f791f1137ca7d52d23559fb4568f7a9026)]:
+  - @mastra/core@1.50.0
+  - @mastra/server@1.50.0
+
+## 1.50.0-alpha.5
+
+### Minor Changes
+
+- Auto-construct a Mastra instance when no `index.ts` exists. If your `src/mastra` ([#18893](https://github.com/mastra-ai/mastra/pull/18893))
+  directory has file-based primitives but no entry file, `mastra dev` and
+  `mastra build` now build and run the project without any boilerplate — no
+  `new Mastra({...})` required.
+
+  ```
+  src/mastra/
+    storage.ts          // export default new LibSQLStore({ url: 'file:./mastra.db' })
+    observability.ts    // export default new Observability({ ... })
+    server.ts           // export default { port: 4111 }
+    studio.ts           // export default { ... }
+    agents/weather/     // file-based agent
+    workflows/report.ts // export default createWorkflow({ ... })
+  ```
+
+  ```sh
+  # No src/mastra/index.ts needed:
+  mastra dev
+  ```
+
+  Projects that already export a `mastra` instance from `index.ts` are unaffected.
+
+- Added file-system-routed agent processors. Place input and output processor files under `agents/<name>/processors/input/` and `agents/<name>/processors/output/`. Each file default-exports a processor, and they are auto-discovered and merged with config-defined processors when running `mastra dev` or `mastra build`. Config-defined processors run first, and a dynamic (function) `inputProcessors`/`outputProcessors` in `config.ts` takes precedence over discovered files. ([#18890](https://github.com/mastra-ai/mastra/pull/18890))
+
+  ```
+  src/mastra/agents/support/
+  ├── config.ts
+  ├── instructions.md
+  └── processors/
+      ├── input/
+      │   └── moderation.ts
+      └── output/
+          └── redact-pii.ts
+  ```
+
+  ```ts
+  // src/mastra/agents/support/processors/input/moderation.ts
+  import { ModerationProcessor } from '@mastra/core/processors';
+
+  export default new ModerationProcessor({ model: 'openai/gpt-5-nano' });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`a0085fa`](https://github.com/mastra-ai/mastra/commit/a0085fa0934e52c37c8c8b3d75a6bb5cd199af36)]:
+  - @mastra/core@1.50.0-alpha.5
+  - @mastra/server@1.50.0-alpha.5
+
 ## 1.50.0-alpha.4
 
 ### Minor Changes

package/dist/build/fs-routing/codegen.d.ts

@@ -18,7 +18,7 @@ import type { DiscoveredFsAgent, DiscoveredFsSingleton, DiscoveredFsWorkflow } f
  * @param userEntry slash-normalized absolute path to the user's mastra entry.
  * @param agents discovered fs-routed agents (absolute, slash-normalized paths).
  */
-export declare function generateFsAgentsModule(userEntry: string, agents: DiscoveredFsAgent[], options?: {
+export declare function generateFsAgentsModule(userEntry: string | undefined, agents: DiscoveredFsAgent[], options?: {
     workflows?: DiscoveredFsWorkflow[];
     storage?: DiscoveredFsSingleton;
     observability?: DiscoveredFsSingleton;

package/dist/build/fs-routing/codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../src/build/fs-routing/codegen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA0HjG;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,iBAAiB,EAAE,EAC3B,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC,GACA,OAAO,CAAC,MAAM,CAAC,CAiIjB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG;IAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAsBA"}
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../src/build/fs-routing/codegen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAgJjG;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,iBAAiB,EAAE,EAC3B,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC,GACA,OAAO,CAAC,MAAM,CAAC,CAkJjB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG;IAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAsBA"}

package/dist/build/fs-routing/discover.d.ts

@@ -27,6 +27,16 @@ export interface DiscoveredFsAgent {
         key: string;
         path: string;
     }[];
+    /** Input processors discovered under `processors/input/`, in stable (sorted) order. */
+    inputProcessors: {
+        key: string;
+        path: string;
+    }[];
+    /** Output processors discovered under `processors/output/`, in stable (sorted) order. */
+    outputProcessors: {
+        key: string;
+        path: string;
+    }[];
     /** Skills discovered under `skills/`, in stable (sorted) order. */
     skills: DiscoveredFsSkill[];
     /**

package/dist/build/fs-routing/discover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/build/fs-routing/discover.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,mEAAmE;IACnE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAAC;AAqSN;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA0B9B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoC5F;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAwBrH"}
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/build/fs-routing/discover.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,uFAAuF;IACvF,eAAe,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,yFAAyF;IACzF,gBAAgB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD,mEAAmE;IACnE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAAC;AA6UN;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA0B9B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoC5F;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAwBrH"}

package/dist/build/fs-routing/prepare.d.ts

@@ -4,8 +4,11 @@ export interface PrepareFsAgentsEntryResult {
      * primitives (agents, workflows, storage, observability, server, studio) are
      * found this is a generated wrapper module that registers them onto the
      * user's mastra instance; otherwise it is the original entry unchanged.
+     * When auto-constructing (no user entry), this is always the generated module.
      */
     entryFile: string;
+    /** Whether a standalone Mastra instance was auto-constructed (no index.ts). */
+    standalone: boolean;
     /**
      * Glob tool paths for tools defined under `agents/*\/tools` so they are
      * bundled alongside the top-level `tools/` directory.
@@ -43,10 +46,14 @@ export interface PrepareFsAgentsEntryResult {
  * the result after `bundler.prepare()` so the generated file is not wiped when
  * the output directory is emptied.
  *
+ * When `entryFile` is `undefined` (no `index.ts`/`index.js`) and fs-routed
+ * primitives are found, a standalone Mastra instance is auto-constructed from
+ * them — no user code required.
+ *
  * When no fs-routed primitives are present the original entry is returned
  * unchanged, so existing code-only projects are completely unaffected.
  */
-export declare function prepareFsAgentsEntry(mastraDir: string, entryFile: string, outputDirectory: string): Promise<PrepareFsAgentsEntryResult>;
+export declare function prepareFsAgentsEntry(mastraDir: string, entryFile: string | undefined, outputDirectory: string): Promise<PrepareFsAgentsEntryResult>;
 /**
  * Write the generated fs-agents wrapper produced by {@link prepareFsAgentsEntry}
  * to its `entryFile`. No-op when there are no fs-routed agents. Call this AFTER

package/dist/build/fs-routing/prepare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/build/fs-routing/prepare.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,0BAA0B,CAAC,CAqDrC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1F"}
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/build/fs-routing/prepare.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,0BAA0B,CAAC,CAkErC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1F"}

package/dist/build/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkQHBSQDGP_cjs = require('../chunk-QHBSQDGP.cjs');
+var chunkBC4D7ZTC_cjs = require('../chunk-BC4D7ZTC.cjs');
 var chunkJFZNJSRK_cjs = require('../chunk-JFZNJSRK.cjs');
 var chunkBDPBIAXY_cjs = require('../chunk-BDPBIAXY.cjs');
 var chunkYZYIXVB4_cjs = require('../chunk-YZYIXVB4.cjs');
@@ -11,47 +11,47 @@ var chunkJZRFRUGM_cjs = require('../chunk-JZRFRUGM.cjs');
 
 Object.defineProperty(exports, "createWatcher", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.createWatcher; }
+  get: function () { return chunkBC4D7ZTC_cjs.createWatcher; }
 });
 Object.defineProperty(exports, "discoverFsAgents", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.discoverFsAgents; }
+  get: function () { return chunkBC4D7ZTC_cjs.discoverFsAgents; }
 });
 Object.defineProperty(exports, "discoverFsSingleton", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.discoverFsSingleton; }
+  get: function () { return chunkBC4D7ZTC_cjs.discoverFsSingleton; }
 });
 Object.defineProperty(exports, "discoverFsWorkflows", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.discoverFsWorkflows; }
+  get: function () { return chunkBC4D7ZTC_cjs.discoverFsWorkflows; }
 });
 Object.defineProperty(exports, "generateFsAgentsModule", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.generateFsAgentsModule; }
+  get: function () { return chunkBC4D7ZTC_cjs.generateFsAgentsModule; }
 });
 Object.defineProperty(exports, "generateFsWorkflowsCodegen", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.generateFsWorkflowsCodegen; }
+  get: function () { return chunkBC4D7ZTC_cjs.generateFsWorkflowsCodegen; }
 });
 Object.defineProperty(exports, "getServerOptions", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.getServerOptions; }
+  get: function () { return chunkBC4D7ZTC_cjs.getServerOptions; }
 });
 Object.defineProperty(exports, "getWatcherInputOptions", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.getInputOptions; }
+  get: function () { return chunkBC4D7ZTC_cjs.getInputOptions; }
 });
 Object.defineProperty(exports, "mirrorFsAgentWorkspaces", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.mirrorFsAgentWorkspaces; }
+  get: function () { return chunkBC4D7ZTC_cjs.mirrorFsAgentWorkspaces; }
 });
 Object.defineProperty(exports, "prepareFsAgentsEntry", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.prepareFsAgentsEntry; }
+  get: function () { return chunkBC4D7ZTC_cjs.prepareFsAgentsEntry; }
 });
 Object.defineProperty(exports, "writeFsAgentsEntry", {
   enumerable: true,
-  get: function () { return chunkQHBSQDGP_cjs.writeFsAgentsEntry; }
+  get: function () { return chunkBC4D7ZTC_cjs.writeFsAgentsEntry; }
 });
 Object.defineProperty(exports, "getBundlerOptions", {
   enumerable: true,

package/dist/build/index.js

@@ -1,4 +1,4 @@
-export { createWatcher, discoverFsAgents, discoverFsSingleton, discoverFsWorkflows, generateFsAgentsModule, generateFsWorkflowsCodegen, getServerOptions, getInputOptions as getWatcherInputOptions, mirrorFsAgentWorkspaces, prepareFsAgentsEntry, writeFsAgentsEntry } from '../chunk-MYYEG5DS.js';
+export { createWatcher, discoverFsAgents, discoverFsSingleton, discoverFsWorkflows, generateFsAgentsModule, generateFsWorkflowsCodegen, getServerOptions, getInputOptions as getWatcherInputOptions, mirrorFsAgentWorkspaces, prepareFsAgentsEntry, writeFsAgentsEntry } from '../chunk-HEGZBAIW.js';
 export { getBundlerOptions } from '../chunk-YPDATVNL.js';
 export { analyzeBundle } from '../chunk-WVXBZMID.js';
 export { createBundler, getInputOptions as getBundlerInputOptions } from '../chunk-TA65GR5X.js';

package/dist/{chunk-QHBSQDGP.cjs → chunk-BC4D7ZTC.cjs}

@@ -189,6 +189,36 @@ async function discoverTools(toolsDir) {
   }
   return tools;
 }
+async function discoverProcessors(processorsDir) {
+  const result = { input: [], output: [] };
+  for (const type of ["input", "output"]) {
+    const typeDir = path.join(processorsDir, type);
+    if (!await exists(typeDir)) {
+      continue;
+    }
+    let entries;
+    try {
+      entries = await promises.readdir(typeDir);
+    } catch {
+      continue;
+    }
+    for (const basename of entries.sort()) {
+      if (isTestFile(basename)) {
+        continue;
+      }
+      if (!TOOL_EXTENSIONS.some((ext) => basename.endsWith(ext))) {
+        continue;
+      }
+      const path$1 = path.join(typeDir, basename);
+      const stats = await promises.lstat(path$1);
+      if (stats.isSymbolicLink() || stats.isDirectory()) {
+        continue;
+      }
+      result[type].push({ key: toolKey(basename), path: chunkJZRFRUGM_cjs.slash(path$1) });
+    }
+  }
+  return result;
+}
 async function readReferences(referencesDir) {
   if (!await exists(referencesDir)) {
     return {};
@@ -277,6 +307,7 @@ async function discoverAgentDir(dir, name, depth, onWarn) {
   const memoryPath = await firstExisting(dir, MEMORY_BASENAMES);
   const workspaceSeedDir = await directoryExists(path.join(dir, "workspace"));
   const tools = await discoverTools(path.join(dir, "tools"));
+  const processors = await discoverProcessors(path.join(dir, "processors"));
   const skills = await discoverSkills(path.join(dir, "skills"));
   const subagents = await discoverSubagents(dir, depth, onWarn);
   return {
@@ -288,6 +319,8 @@ async function discoverAgentDir(dir, name, depth, onWarn) {
     memoryPath,
     workspaceSeedDir,
     tools,
+    inputProcessors: processors.input,
+    outputProcessors: processors.output,
     skills,
     subagents
   };
@@ -427,6 +460,20 @@ async function emitAgentEntry(agent, idPath, workspaceName, lines) {
     lines.push(`import ${ident} from ${JSON.stringify(tool.path)};`);
     toolIdents.push({ key: tool.key, ident });
   }
+  const inputProcessorIdents = [];
+  for (let p = 0; p < agent.inputProcessors.length; p++) {
+    const proc = agent.inputProcessors[p];
+    const ident = sanitizeIdentifier(`${agent.name}_inputProc_${proc.key}`, "proc", `${idPath}_ip${p}`);
+    lines.push(`import ${ident} from ${JSON.stringify(proc.path)};`);
+    inputProcessorIdents.push(ident);
+  }
+  const outputProcessorIdents = [];
+  for (let p = 0; p < agent.outputProcessors.length; p++) {
+    const proc = agent.outputProcessors[p];
+    const ident = sanitizeIdentifier(`${agent.name}_outputProc_${proc.key}`, "proc", `${idPath}_op${p}`);
+    lines.push(`import ${ident} from ${JSON.stringify(proc.path)};`);
+    outputProcessorIdents.push(ident);
+  }
   const skillExprs = [];
   const agentSkills = agent.skills ?? [];
   for (let s = 0; s < agentSkills.length; s++) {
@@ -474,6 +521,12 @@ async function emitAgentEntry(agent, idPath, workspaceName, lines) {
   if (skillExprs.length > 0) {
     entryFields.push(`skills: [${skillExprs.join(", ")}]`);
   }
+  if (inputProcessorIdents.length > 0) {
+    entryFields.push(`inputProcessors: [${inputProcessorIdents.join(", ")}]`);
+  }
+  if (outputProcessorIdents.length > 0) {
+    entryFields.push(`outputProcessors: [${outputProcessorIdents.join(", ")}]`);
+  }
   if (subagentExprs.length > 0) {
     entryFields.push(`subagents: [${subagentExprs.join(", ")}]`);
   }
@@ -492,6 +545,7 @@ async function generateFsAgentsModule(userEntry, agents, options) {
   const observability = options?.observability;
   const server = options?.server;
   const studio = options?.studio;
+  const standalone = userEntry === void 0;
   const lines = [];
   const hasInlineSkills = (function check(list) {
     return list.some((a) => (a.skills ?? []).some((s) => s.kind === "packaged") || check(a.subagents ?? []));
@@ -500,10 +554,15 @@ async function generateFsAgentsModule(userEntry, agents, options) {
   if (hasInlineSkills) {
     lines.push(`import { createSkill as __createSkill } from '@mastra/core/skills';`);
   }
+  if (standalone) {
+    lines.push(`import { Mastra } from '@mastra/core';`);
+  }
   lines.push(`import { fileURLToPath as __fileURLToPath } from 'node:url';`);
   lines.push(`import { dirname as __dirname, join as __join } from 'node:path';`);
-  lines.push(`import * as __userEntry from ${JSON.stringify(userEntry)};`);
-  lines.push(`export * from ${JSON.stringify(userEntry)};`);
+  if (userEntry) {
+    lines.push(`import * as __userEntry from ${JSON.stringify(userEntry)};`);
+    lines.push(`export * from ${JSON.stringify(userEntry)};`);
+  }
   lines.push(``);
   lines.push(`const __bundleDir = __dirname(__fileURLToPath(import.meta.url));`);
   lines.push(`const __workspaceBasePath = name => __join(__bundleDir, 'workspace', ...name.split('/'));`);
@@ -538,6 +597,13 @@ async function generateFsAgentsModule(userEntry, agents, options) {
     const expr = await emitAgentEntry(agent, `${i}`, agent.name, lines);
     entryExprs.push(expr);
   }
+  if (standalone) {
+    lines.push(``);
+    lines.push(`const __mastra = new Mastra({});`);
+  } else {
+    lines.push(``);
+    lines.push(`const __mastra = __userEntry.mastra;`);
+  }
   lines.push(``);
   lines.push(`const __fsAgentEntries = [`);
   for (const expr of entryExprs) {
@@ -548,36 +614,36 @@ async function generateFsAgentsModule(userEntry, agents, options) {
   lines.push(`const __fsAgents = Object.create(null);`);
   lines.push(`for (const __entry of __fsAgentEntries) {`);
   lines.push(`  __fsAgents[__entry.name] = assembleAgentFromFsEntry(__entry, {`);
-  lines.push(`    onWarn: msg => __userEntry.mastra?.getLogger?.()?.warn?.(msg) ?? console.warn(msg),`);
+  lines.push(`    onWarn: msg => __mastra?.getLogger?.()?.warn?.(msg) ?? console.warn(msg),`);
   lines.push(`  });`);
   lines.push(`}`);
   lines.push(``);
   if (storage) {
-    lines.push(`if (__userEntry.mastra && typeof __userEntry.mastra.__registerFsStorage === 'function') {`);
-    lines.push(`  __userEntry.mastra.__registerFsStorage(__fsStorage);`);
+    lines.push(`if (__mastra && typeof __mastra.__registerFsStorage === 'function') {`);
+    lines.push(`  __mastra.__registerFsStorage(__fsStorage);`);
     lines.push(`}`);
     lines.push(``);
   }
   if (observability) {
-    lines.push(`if (__userEntry.mastra && typeof __userEntry.mastra.__registerFsObservability === 'function') {`);
-    lines.push(`  __userEntry.mastra.__registerFsObservability(__fsObservability);`);
+    lines.push(`if (__mastra && typeof __mastra.__registerFsObservability === 'function') {`);
+    lines.push(`  __mastra.__registerFsObservability(__fsObservability);`);
     lines.push(`}`);
     lines.push(``);
   }
   if (server) {
-    lines.push(`if (__userEntry.mastra && typeof __userEntry.mastra.__registerFsServer === 'function') {`);
-    lines.push(`  __userEntry.mastra.__registerFsServer(__fsServer);`);
+    lines.push(`if (__mastra && typeof __mastra.__registerFsServer === 'function') {`);
+    lines.push(`  __mastra.__registerFsServer(__fsServer);`);
     lines.push(`}`);
     lines.push(``);
   }
   if (studio) {
-    lines.push(`if (__userEntry.mastra && typeof __userEntry.mastra.__registerFsStudio === 'function') {`);
-    lines.push(`  __userEntry.mastra.__registerFsStudio(__fsStudio);`);
+    lines.push(`if (__mastra && typeof __mastra.__registerFsStudio === 'function') {`);
+    lines.push(`  __mastra.__registerFsStudio(__fsStudio);`);
     lines.push(`}`);
     lines.push(``);
   }
-  lines.push(`if (__userEntry.mastra && typeof __userEntry.mastra.__registerFsAgents === 'function') {`);
-  lines.push(`  __userEntry.mastra.__registerFsAgents(__fsAgents);`);
+  lines.push(`if (__mastra && typeof __mastra.__registerFsAgents === 'function') {`);
+  lines.push(`  __mastra.__registerFsAgents(__fsAgents);`);
   lines.push(`}`);
   if (wfCodegen) {
     lines.push(``);
@@ -586,7 +652,7 @@ async function generateFsAgentsModule(userEntry, agents, options) {
     }
   }
   lines.push(``);
-  lines.push(`export const mastra = __userEntry.mastra;`);
+  lines.push(`export const mastra = __mastra;`);
   return lines.join("\n");
 }
 function generateFsWorkflowsCodegen(workflows) {
@@ -604,8 +670,8 @@ function generateFsWorkflowsCodegen(workflows) {
     registrationLines.push(`__fsWorkflows[${JSON.stringify(wf.key)}] = ${ident};`);
   }
   registrationLines.push(``);
-  registrationLines.push(`if (__userEntry.mastra && typeof __userEntry.mastra.__registerFsWorkflows === 'function') {`);
-  registrationLines.push(`  __userEntry.mastra.__registerFsWorkflows(__fsWorkflows);`);
+  registrationLines.push(`if (__mastra && typeof __mastra.__registerFsWorkflows === 'function') {`);
+  registrationLines.push(`  __mastra.__registerFsWorkflows(__fsWorkflows);`);
   registrationLines.push(`}`);
   return { importLines, registrationLines };
 }
@@ -618,9 +684,12 @@ async function prepareFsAgentsEntry(mastraDir, entryFile, outputDirectory) {
     discoverFsSingleton(mastraDir, "server"),
     discoverFsSingleton(mastraDir, "studio")
   ]);
-  if (agents.length === 0 && workflows.length === 0 && !storage && !observability && !server && !studio) {
+  const standalone = entryFile === void 0;
+  const hasFsPrimitives = agents.length > 0 || workflows.length > 0 || !!storage || !!observability || !!server || !!studio;
+  if (!hasFsPrimitives && entryFile !== void 0) {
     return {
       entryFile,
+      standalone: false,
       toolPaths: [],
       agentCount: 0,
       workflowCount: 0,
@@ -630,7 +699,12 @@ async function prepareFsAgentsEntry(mastraDir, entryFile, outputDirectory) {
       hasStudio: false
     };
   }
-  const moduleSource = await generateFsAgentsModule(chunkJZRFRUGM_cjs.slash(entryFile), agents, {
+  if (!hasFsPrimitives && standalone) {
+    throw new Error(
+      "No index.ts and no file-based primitives found. Create src/mastra/index.ts with a Mastra instance, or add file-based agents/workflows/storage."
+    );
+  }
+  const moduleSource = await generateFsAgentsModule(entryFile ? chunkJZRFRUGM_cjs.slash(entryFile) : void 0, agents, {
     workflows,
     storage,
     observability,
@@ -646,6 +720,7 @@ async function prepareFsAgentsEntry(mastraDir, entryFile, outputDirectory) {
   ] : [];
   return {
     entryFile: generatedEntry,
+    standalone,
     toolPaths,
     agentCount: agents.length,
     workflowCount: workflows.length,
@@ -698,5 +773,5 @@ exports.getServerOptions = getServerOptions;
 exports.mirrorFsAgentWorkspaces = mirrorFsAgentWorkspaces;
 exports.prepareFsAgentsEntry = prepareFsAgentsEntry;
 exports.writeFsAgentsEntry = writeFsAgentsEntry;
-//# sourceMappingURL=chunk-QHBSQDGP.cjs.map
-//# sourceMappingURL=chunk-QHBSQDGP.cjs.map
+//# sourceMappingURL=chunk-BC4D7ZTC.cjs.map
+//# sourceMappingURL=chunk-BC4D7ZTC.cjs.map