@nightowlsdev/engine-mastra 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Night Owls contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @nightowlsdev/engine-mastra
+
+> The default Mastra engine, given a name in the `engine-*` family — a re-export facade over `@nightowlsdev/core`.
+
+Per the pluggable-engine architecture (`docs/strategy/2026-07-03-pluggable-engine-architecture.md` §2b), this
+package is **v0 = a facade**: the swarm loop physically stays inside `@nightowlsdev/core` until `core@1.0`
+(when the loop + the Mastra half of storage move in one coordinated wave). Installing `engine-mastra` and
+passing `mastraEngine()` to `defineSwarm({ engine })` constructs the **exact same** `SwarmEngine` `defineSwarm`
+builds by default when `engine` is omitted — it changes imports, not behavior.
+
+## Install
+
+```sh
+pnpm add @nightowlsdev/engine-mastra
+```
+
+## Usage
+
+```ts
+import { defineSwarm } from "@nightowlsdev/core";
+import { mastraEngine } from "@nightowlsdev/engine-mastra";
+
+export default defineSwarm({
+  // ...
+  engine: mastraEngine(),
+});
+```
+
+Omitting `engine` entirely is byte-identical — `defineSwarm` defaults to the built-in Mastra `SwarmEngine`
+already. `engine-mastra` exists so the default engine has a named, CLI-installable package in the `engine-*`
+family, matching `engine-ai-sdk` and the adapter tier (`engine-agui`, `engine-eve`, `engine-trigger-chat`).
+
+## API
+
+### `mastraEngine()`
+
+```ts
+function mastraEngine(): (opts: AssembledEngineOpts) => Engine
+```
+
+Returns an engine factory for `defineSwarm({ engine })`. Constructs a `SwarmEngine` from the fully-assembled
+`AssembledEngineOpts` `defineSwarm` hands it (composed hooks, skill resolver, workflows, telemetry, secrets,
+`onEvent`, …) — the same construction `defineSwarm` performs internally when `engine` is omitted.
+
+### `MastraEngine`
+
+Identity re-export of `@nightowlsdev/core`'s `SwarmEngine` class, under its family name.
+
+### `MASTRA_ENGINE_CAPABILITIES`
+
+Re-export of the Mastra engine's static `EngineCapabilities` descriptor.
+
+### `nightOwlsPlugin`
+
+The declarative plugin manifest consumed by `@nightowlsdev/cli` (`kind: "engine"`). Data-only — it does not
+import from `@nightowlsdev/cli` (no dependency cycle).
+
+## See also
+
+- `docs/spec/ENGINE-CONTRACT.md` — the normative structural `Engine` interface + behavioral invariants every
+  engine (this one included) must satisfy.
+- `docs/strategy/2026-07-03-pluggable-engine-architecture.md` §2b — why v0 is a facade and when the loop moves.

package/dist/index.cjs

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MASTRA_ENGINE_CAPABILITIES: () => import_core2.MASTRA_ENGINE_CAPABILITIES,
+  MastraEngine: () => import_core2.SwarmEngine,
+  mastraEngine: () => mastraEngine,
+  nightOwlsPlugin: () => nightOwlsPlugin
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@nightowlsdev/core");
+var import_core2 = require("@nightowlsdev/core");
+function mastraEngine() {
+  return (opts) => new import_core.SwarmEngine(opts);
+}
+var nightOwlsPlugin = {
+  name: "engine-mastra",
+  version: "0.0.0",
+  kind: "engine",
+  pkg: "@nightowlsdev/engine-mastra",
+  description: "The default Mastra engine as a named engine package (re-export facade).",
+  env: [],
+  config: {
+    import: `import { mastraEngine } from "@nightowlsdev/engine-mastra";`,
+    snippet: `engine = mastraEngine();`,
+    marker: "engine"
+  },
+  // Print-only (idempotent) — runs on init/install + `owl init engine-mastra`. NEVER connects anywhere.
+  init: (ctx) => ctx.log("engine-mastra wired \u2014 defineSwarm({ engine: mastraEngine() }); omitting `engine` is byte-identical."),
+  commands: []
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MASTRA_ENGINE_CAPABILITIES,
+  MastraEngine,
+  mastraEngine,
+  nightOwlsPlugin
+});

package/dist/index.d.cts

@@ -0,0 +1,35 @@
+import { AssembledEngineOpts, Engine } from '@nightowlsdev/core';
+export { AssembledEngineOpts, Engine, EngineCapabilities, MASTRA_ENGINE_CAPABILITIES, SwarmEngine as MastraEngine } from '@nightowlsdev/core';
+
+/**
+ * Engine factory for `defineSwarm({ engine: mastraEngine() })` — constructs the SAME
+ * SwarmEngine `defineSwarm` builds by default. Installing this package + passing the
+ * factory changes imports, never behavior.
+ */
+declare function mastraEngine(): (opts: AssembledEngineOpts) => Engine;
+/**
+ * The declarative Night Owls plugin manifest consumed by `@nightowlsdev/cli`. STRUCTURALLY matches the CLI's
+ * `NightOwlsPlugin` type but does NOT import it (no dependency cycle): all codegen lives in `@nightowlsdev/cli`;
+ * this adapter stays data-only. NOTE: the CLI's `kind`/`marker` unions don't include `"engine"` yet (P2-2,
+ * a separate task) — this manifest is data-only and structurally typed, so it compiles independently of that.
+ */
+declare const nightOwlsPlugin: {
+    readonly name: "engine-mastra";
+    readonly version: "0.0.0";
+    readonly kind: "engine";
+    readonly pkg: "@nightowlsdev/engine-mastra";
+    readonly description: "The default Mastra engine as a named engine package (re-export facade).";
+    readonly env: readonly [];
+    readonly config: {
+        readonly import: "import { mastraEngine } from \"@nightowlsdev/engine-mastra\";";
+        readonly snippet: "engine = mastraEngine();";
+        readonly marker: "engine";
+    };
+    readonly init: (ctx: {
+        cwd: string;
+        log: (m: string) => void;
+    }) => void;
+    readonly commands: readonly [];
+};
+
+export { mastraEngine, nightOwlsPlugin };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { AssembledEngineOpts, Engine } from '@nightowlsdev/core';
+export { AssembledEngineOpts, Engine, EngineCapabilities, MASTRA_ENGINE_CAPABILITIES, SwarmEngine as MastraEngine } from '@nightowlsdev/core';
+
+/**
+ * Engine factory for `defineSwarm({ engine: mastraEngine() })` — constructs the SAME
+ * SwarmEngine `defineSwarm` builds by default. Installing this package + passing the
+ * factory changes imports, never behavior.
+ */
+declare function mastraEngine(): (opts: AssembledEngineOpts) => Engine;
+/**
+ * The declarative Night Owls plugin manifest consumed by `@nightowlsdev/cli`. STRUCTURALLY matches the CLI's
+ * `NightOwlsPlugin` type but does NOT import it (no dependency cycle): all codegen lives in `@nightowlsdev/cli`;
+ * this adapter stays data-only. NOTE: the CLI's `kind`/`marker` unions don't include `"engine"` yet (P2-2,
+ * a separate task) — this manifest is data-only and structurally typed, so it compiles independently of that.
+ */
+declare const nightOwlsPlugin: {
+    readonly name: "engine-mastra";
+    readonly version: "0.0.0";
+    readonly kind: "engine";
+    readonly pkg: "@nightowlsdev/engine-mastra";
+    readonly description: "The default Mastra engine as a named engine package (re-export facade).";
+    readonly env: readonly [];
+    readonly config: {
+        readonly import: "import { mastraEngine } from \"@nightowlsdev/engine-mastra\";";
+        readonly snippet: "engine = mastraEngine();";
+        readonly marker: "engine";
+    };
+    readonly init: (ctx: {
+        cwd: string;
+        log: (m: string) => void;
+    }) => void;
+    readonly commands: readonly [];
+};
+
+export { mastraEngine, nightOwlsPlugin };

package/dist/index.js

@@ -0,0 +1,28 @@
+// src/index.ts
+import { SwarmEngine } from "@nightowlsdev/core";
+import { SwarmEngine as SwarmEngine2, MASTRA_ENGINE_CAPABILITIES } from "@nightowlsdev/core";
+function mastraEngine() {
+  return (opts) => new SwarmEngine(opts);
+}
+var nightOwlsPlugin = {
+  name: "engine-mastra",
+  version: "0.0.0",
+  kind: "engine",
+  pkg: "@nightowlsdev/engine-mastra",
+  description: "The default Mastra engine as a named engine package (re-export facade).",
+  env: [],
+  config: {
+    import: `import { mastraEngine } from "@nightowlsdev/engine-mastra";`,
+    snippet: `engine = mastraEngine();`,
+    marker: "engine"
+  },
+  // Print-only (idempotent) — runs on init/install + `owl init engine-mastra`. NEVER connects anywhere.
+  init: (ctx) => ctx.log("engine-mastra wired \u2014 defineSwarm({ engine: mastraEngine() }); omitting `engine` is byte-identical."),
+  commands: []
+};
+export {
+  MASTRA_ENGINE_CAPABILITIES,
+  SwarmEngine2 as MastraEngine,
+  mastraEngine,
+  nightOwlsPlugin
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@nightowlsdev/engine-mastra",
+  "description": "The default Mastra engine as a named engine package — a re-export facade over @nightowlsdev/core (the loop stays in core until core@1.0).",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cueplusplus/corale.git",
+    "directory": "packages/engine-mastra"
+  },
+  "homepage": "https://github.com/cueplusplus/corale#readme",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@nightowlsdev/core": "0.13.0"
+  },
+  "devDependencies": {
+    "ai": "^6.0.0",
+    "tsup": "8.5.1",
+    "typescript": "6.0.3",
+    "vitest": "^3.2.0",
+    "@nightowlsdev/core": "0.13.0",
+    "@nightowlsdev/eslint-config": "0.0.0",
+    "@nightowlsdev/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}