@frontmcp/nx 1.8.6 → 1.8.7

package/generators/agent/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/generators/agent/agent.ts"],"names":[],"mappings":";;AAKA,wCAoBC;AAzBD,uCAA2F;AAC3F,+BAA4B;AAE5B,2EAA6E;AAEtE,KAAK,UAAU,cAAc,CAAC,IAAU,EAAE,MAA4B;IAC3E,MAAM,OAAO,GAAG,IAAA,gDAAyB,EAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK;QAC3B,CAAC,CAAC,MAAM,CAAC,KAAK;aACT,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;IAEP,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE;QAC/D,GAAG,OAAO;QACV,KAAK;QACL,QAAQ;QACR,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kBAAe,cAAc,CAAC","sourcesContent":["import { type Tree, formatFiles, generateFiles, type GeneratorCallback } from '@nx/devkit';\nimport { join } from 'path';\nimport type { AgentGeneratorSchema } from './schema.js';\nimport { normalizePrimitiveOptions } from '../../utils/normalize-options.js';\n\nexport async function agentGenerator(tree: Tree, schema: AgentGeneratorSchema): Promise<GeneratorCallback | void> {\n  const options = normalizePrimitiveOptions(tree, schema, 'agents');\n  const model = schema.model ?? 'gpt-4';\n  const toolRefs = schema.tools\n    ? schema.tools\n        .split(',')\n        .map((t) => t.trim())\n        .filter(Boolean)\n    : [];\n\n  generateFiles(tree, join(__dirname, 'files'), options.directory, {\n    ...options,\n    model,\n    toolRefs,\n    tmpl: '',\n  });\n\n  if (!schema.skipFormat) {\n    await formatFiles(tree);\n  }\n}\n\nexport default agentGenerator;\n"]}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/generators/agent/agent.ts"],"names":[],"mappings":";;AAQA,wCAiCC;AAzCD,+BAAsC;AAEtC,uCAAkG;AAElG,mDAAkD;AAClD,2EAA6E;AAGtE,KAAK,UAAU,cAAc,CAAC,IAAU,EAAE,MAA4B;IAC3E,MAAM,OAAO,GAAG,IAAA,gDAAyB,EAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SAClC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAA,cAAK,EAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAA,qBAAU,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACxE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;SACtF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,UAAU,GAAG,IAAA,eAAQ,EAAC,OAAO,CAAC,SAAS,EAAE,IAAA,WAAI,EAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC;aACjF,KAAK,CAAC,IAAI,CAAC;aACX,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO;YACL,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE;SACxE,CAAC;IACJ,CAAC,CAAC,CAAC;IACL,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE7D,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE;QAC/D,GAAG,OAAO;QACV,KAAK;QACL,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;QACjD,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB;QAC/D,QAAQ;QACR,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kBAAe,cAAc,CAAC","sourcesContent":["import { join, relative } from 'path';\n\nimport { formatFiles, generateFiles, names, type GeneratorCallback, type Tree } from '@nx/devkit';\n\nimport { toFileName } from '../../utils/names.js';\nimport { normalizePrimitiveOptions } from '../../utils/normalize-options.js';\nimport type { AgentGeneratorSchema } from './schema.js';\n\nexport async function agentGenerator(tree: Tree, schema: AgentGeneratorSchema): Promise<GeneratorCallback | void> {\n  const options = normalizePrimitiveOptions(tree, schema, 'agents');\n  const model = schema.model ?? 'gpt-4';\n  const toolsDir = join(options.projectSourceRoot, 'tools');\n  const toolRefs = (schema.tools ?? '')\n    .split(',')\n    .map((t) => t.trim())\n    .filter(Boolean)\n    .map((t) => ({ className: names(t).className, fileName: toFileName(t) }))\n    .filter((t, i, all) => all.findIndex((other) => other.className === t.className) === i)\n    .map((t) => {\n      const importPath = relative(options.directory, join(toolsDir, `${t.fileName}.tool`))\n        .split('\\\\')\n        .join('/');\n      return {\n        className: t.className,\n        importPath: importPath.startsWith('.') ? importPath : `./${importPath}`,\n      };\n    });\n  const isAnthropic = model.toLowerCase().startsWith('claude');\n\n  generateFiles(tree, join(__dirname, 'files'), options.directory, {\n    ...options,\n    model,\n    llmProvider: isAnthropic ? 'anthropic' : 'openai',\n    apiKeyEnv: isAnthropic ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY',\n    toolRefs,\n    tmpl: '',\n  });\n\n  if (!schema.skipFormat) {\n    await formatFiles(tree);\n  }\n}\n\nexport default agentGenerator;\n"]}

package/generators/agent/files/__fileName__.agent.ts__tmpl__

@@ -1,17 +1,23 @@
-import { Agent, AgentContext } from '@frontmcp/sdk';
-
+import { Agent, AgentContext, z } from '@frontmcp/sdk';
+<% toolRefs.forEach(t => { %>import <%= t.className %>Tool from '<%= t.importPath %>';
+<% }) %>
 @Agent({
   name: '<%= name %>',
   description: 'TODO: describe what this agent does',
   llm: {
+    provider: '<%= llmProvider %>',
     model: '<%= model %>',
+    apiKey: { env: '<%= apiKeyEnv %>' },
+  },
+  inputSchema: {
+    task: z.string().describe('TODO: describe the task the agent should perform'),
   },<% if (toolRefs.length > 0) { %>
-  tools: [<%- toolRefs.map(t => `'${t}'`).join(', ') %>],<% } %>
+  tools: [<%- toolRefs.map(t => `${t.className}Tool`).join(', ') %>],<% } %>
   systemInstructions: 'TODO: define system instructions for this agent',
 })
 export default class <%= className %>Agent extends AgentContext {
-  async execute(input: unknown): Promise<unknown> {
-    // TODO: implement agent logic
-    return {};
+  async execute(input: { task: string }) {
+    // The default implementation runs the LLM loop with the agent's tools.
+    return super.execute(input);
   }
 }

package/generators/app/app.d.ts

@@ -1,4 +1,4 @@
-import { type Tree, type GeneratorCallback } from '@nx/devkit';
+import { type GeneratorCallback, type Tree } from '@nx/devkit';
 import type { AppGeneratorSchema } from './schema.js';
 export declare function appGenerator(tree: Tree, schema: AppGeneratorSchema): Promise<GeneratorCallback | void>;
 export default appGenerator;

package/generators/app/app.js

@@ -1,15 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.appGenerator = appGenerator;
-const devkit_1 = require("@nx/devkit");
 const path_1 = require("path");
+const devkit_1 = require("@nx/devkit");
 const index_js_1 = require("./lib/index.js");
 async function appGenerator(tree, schema) {
     return appGeneratorInternal(tree, schema);
 }
 async function appGeneratorInternal(tree, schema) {
-    const options = (0, index_js_1.normalizeOptions)(schema);
-    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files'), options.projectRoot, {
+    const options = (0, index_js_1.normalizeOptions)(tree, schema);
+    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files'), options.outputRoot, {
         ...options,
         tmpl: '',
     });

package/generators/app/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../src/generators/app/app.ts"],"names":[],"mappings":";;AAKA,oCAEC;AAPD,uCAA2F;AAC3F,+BAA4B;AAE5B,6CAAkD;AAE3C,KAAK,UAAU,YAAY,CAAC,IAAU,EAAE,MAA0B;IACvE,OAAO,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAU,EAAE,MAA0B;IACxE,MAAM,OAAO,GAAG,IAAA,2BAAgB,EAAC,MAAM,CAAC,CAAC;IAEzC,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE;QACjE,GAAG,OAAO;QACV,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kBAAe,YAAY,CAAC","sourcesContent":["import { type Tree, formatFiles, generateFiles, type GeneratorCallback } from '@nx/devkit';\nimport { join } from 'path';\nimport type { AppGeneratorSchema } from './schema.js';\nimport { normalizeOptions } from './lib/index.js';\n\nexport async function appGenerator(tree: Tree, schema: AppGeneratorSchema): Promise<GeneratorCallback | void> {\n  return appGeneratorInternal(tree, schema);\n}\n\nasync function appGeneratorInternal(tree: Tree, schema: AppGeneratorSchema): Promise<GeneratorCallback | void> {\n  const options = normalizeOptions(schema);\n\n  generateFiles(tree, join(__dirname, 'files'), options.projectRoot, {\n    ...options,\n    tmpl: '',\n  });\n\n  if (!options.skipFormat) {\n    await formatFiles(tree);\n  }\n}\n\nexport default appGenerator;\n"]}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../src/generators/app/app.ts"],"names":[],"mappings":";;AAOA,oCAEC;AATD,+BAA4B;AAE5B,uCAA2F;AAE3F,6CAAkD;AAG3C,KAAK,UAAU,YAAY,CAAC,IAAU,EAAE,MAA0B;IACvE,OAAO,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAU,EAAE,MAA0B;IACxE,MAAM,OAAO,GAAG,IAAA,2BAAgB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE/C,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE;QAChE,GAAG,OAAO;QACV,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kBAAe,YAAY,CAAC","sourcesContent":["import { join } from 'path';\n\nimport { formatFiles, generateFiles, type GeneratorCallback, type Tree } from '@nx/devkit';\n\nimport { normalizeOptions } from './lib/index.js';\nimport type { AppGeneratorSchema } from './schema.js';\n\nexport async function appGenerator(tree: Tree, schema: AppGeneratorSchema): Promise<GeneratorCallback | void> {\n  return appGeneratorInternal(tree, schema);\n}\n\nasync function appGeneratorInternal(tree: Tree, schema: AppGeneratorSchema): Promise<GeneratorCallback | void> {\n  const options = normalizeOptions(tree, schema);\n\n  generateFiles(tree, join(__dirname, 'files'), options.outputRoot, {\n    ...options,\n    tmpl: '',\n  });\n\n  if (!options.skipFormat) {\n    await formatFiles(tree);\n  }\n}\n\nexport default appGenerator;\n"]}

package/generators/app/files/jest.config.cjs__tmpl__

@@ -0,0 +1,37 @@
+const { join } = require('path');
+const ts = require('typescript');
+
+// Mirror the tsconfig.base.json path aliases so imports across projects (e.g. `@scope/lib`) resolve in tests.
+const workspaceRoot = join(__dirname, '<%= offset %>');
+const { config: baseConfig } = ts.readConfigFile(join(workspaceRoot, 'tsconfig.base.json'), ts.sys.readFile);
+const aliases = (baseConfig && baseConfig.compilerOptions && baseConfig.compilerOptions.paths) || {};
+const moduleNameMapper = Object.fromEntries(
+  Object.entries(aliases).map(([alias, [target]]) => [
+    '^' + alias.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace('*', '(.*)') + '$',
+    join(workspaceRoot, target).replace('*', '$1'),
+  ]),
+);
+
+module.exports = {
+  displayName: '<%= projectName %>',
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.[tj]s$': ['@swc/jest', {
+      jsc: {
+        target: 'es2022',
+        parser: { syntax: 'typescript', decorators: true, dynamicImport: true },
+        transform: { decoratorMetadata: true, legacyDecorator: true },
+        keepClassNames: true,
+        externalHelpers: true,
+        loose: true,
+      },
+      sourceMaps: true,
+      swcrc: false,
+    }],
+  },
+  setupFilesAfterEnv: ['@frontmcp/testing/setup'],
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  moduleNameMapper,
+  // Transpile ESM-only deps; the `.pnpm` skip keeps this correct under pnpm (issue #519).
+  transformIgnorePatterns: ['node_modules[/\\\\](?!\\.pnpm[/\\\\])(?!(jose)[/\\\\])'],
+};

package/generators/app/files/package.json__tmpl__

@@ -0,0 +1,5 @@
+{
+  "name": "<%= projectName %>",
+  "version": "0.0.1",
+  "private": true
+}

package/generators/app/files/project.json__tmpl__

@@ -1,12 +1,13 @@
 {
   "name": "<%= projectName %>",
-  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "$schema": "<%= offset %>node_modules/nx/schemas/project-schema.json",
   "sourceRoot": "<%= projectRoot %>/src",
   "projectType": "application",
   "tags": [<%- parsedTags.map(t => `"${t}"`).join(', ') %>],
   "targets": {
     "build": {
       "executor": "@frontmcp/nx:build",
+      "cache": true,
       "outputs": ["{projectRoot}/dist"],
       "options": {
         "entry": "{projectRoot}/src/main.ts",
@@ -27,6 +28,7 @@
     },
     "test": {
       "executor": "@frontmcp/nx:test",
+      "cache": true,
       "options": {}
     },
     "inspector": {

package/generators/app/files/tsconfig.json__tmpl__

@@ -1,17 +1,14 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "<%= offset %>tsconfig.base.json",
   "compilerOptions": {
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
+    "module": "commonjs",
+    "moduleResolution": "node10",<% if (ignoreDeprecations) { %>
+    "ignoreDeprecations": "<%= ignoreDeprecations %>",<% } %>
     "forceConsistentCasingInFileNames": true,
     "strict": true,
     "emitDecoratorMetadata": true,
     "experimentalDecorators": true
   },
-  "files": [],
-  "include": [],
-  "references": [
-    { "path": "./tsconfig.lib.json" },
-    { "path": "./tsconfig.spec.json" }
-  ]
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/**/*.spec.ts", "src/**/*.test.ts"]
 }

package/generators/app/files/tsconfig.lib.json__tmpl__

@@ -2,10 +2,9 @@
   "extends": "./tsconfig.json",
   "compilerOptions": {
     "outDir": "./dist",
-    "rootDir": "./src",
     "declaration": true,
     "types": ["node"]
   },
   "include": ["src/**/*.ts"],
-  "exclude": ["jest.config.ts", "src/**/*.spec.ts", "src/**/*.test.ts"]
+  "exclude": ["src/**/*.spec.ts", "src/**/*.test.ts"]
 }

package/generators/app/files/tsconfig.spec.json__tmpl__

@@ -1,10 +1,9 @@
 {
   "extends": "./tsconfig.json",
   "compilerOptions": {
-    "outDir": "../../dist/out-tsc",
-    "module": "commonjs",
-    "moduleResolution": "NodeNext",
+    "outDir": "<%= offset %>dist/out-tsc",
     "types": ["jest", "node"]
   },
-  "include": ["jest.config.ts", "src/**/*.test.ts", "src/**/*.spec.ts", "src/**/*.d.ts"]
+  "include": ["src/**/*.test.ts", "src/**/*.spec.ts", "src/**/*.d.ts"],
+  "exclude": []
 }

package/generators/app/lib/normalize-options.d.ts

@@ -1,12 +1,19 @@
+import { type Tree } from '@nx/devkit';
 import type { AppGeneratorSchema } from '../schema.js';
 export interface NormalizedAppOptions {
     name: string;
     projectName: string;
+    /** Project root relative to the Nx workspace root. */
     projectRoot: string;
+    /** Where the files are written, relative to the tree root. */
+    outputRoot: string;
+    /** Path from the project back to the workspace root, e.g. `../../`. */
+    offset: string;
+    ignoreDeprecations: string;
     className: string;
     fileName: string;
     propertyName: string;
     parsedTags: string[];
     skipFormat: boolean;
 }
-export declare function normalizeOptions(schema: AppGeneratorSchema): NormalizedAppOptions;
+export declare function normalizeOptions(tree: Tree, schema: AppGeneratorSchema): NormalizedAppOptions;

package/generators/app/lib/normalize-options.js

@@ -2,14 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeOptions = normalizeOptions;
 const devkit_1 = require("@nx/devkit");
-function normalizeOptions(schema) {
+const project_paths_js_1 = require("../../../utils/project-paths.js");
+function normalizeOptions(tree, schema) {
     const { className, fileName, propertyName } = (0, devkit_1.names)(schema.name);
-    const projectRoot = schema.directory ?? (0, devkit_1.joinPathFragments)('apps', fileName);
+    const outputRoot = schema.directory ?? (0, devkit_1.joinPathFragments)(schema.workspaceRoot ?? '', 'apps', fileName);
+    const { projectRoot, offset } = (0, project_paths_js_1.resolveProjectPaths)(outputRoot, schema.workspaceRoot);
     const parsedTags = schema.tags ? schema.tags.split(',').map((t) => t.trim()) : ['scope:apps'];
     return {
         name: schema.name,
         projectName: fileName,
         projectRoot,
+        outputRoot,
+        offset,
+        ignoreDeprecations: (0, project_paths_js_1.getIgnoreDeprecations)(tree, schema.workspaceRoot),
         className,
         fileName,
         propertyName,

package/generators/app/lib/normalize-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-options.js","sourceRoot":"","sources":["../../../../../src/generators/app/lib/normalize-options.ts"],"names":[],"mappings":";;AAcA,4CAeC;AA7BD,uCAAsD;AActD,SAAgB,gBAAgB,CAAC,MAA0B;IACzD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,0BAAiB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAE9F,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,QAAQ;QACrB,WAAW;QACX,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,UAAU;QACV,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;KACvC,CAAC;AACJ,CAAC","sourcesContent":["import { names, joinPathFragments } from '@nx/devkit';\nimport type { AppGeneratorSchema } from '../schema.js';\n\nexport interface NormalizedAppOptions {\n  name: string;\n  projectName: string;\n  projectRoot: string;\n  className: string;\n  fileName: string;\n  propertyName: string;\n  parsedTags: string[];\n  skipFormat: boolean;\n}\n\nexport function normalizeOptions(schema: AppGeneratorSchema): NormalizedAppOptions {\n  const { className, fileName, propertyName } = names(schema.name);\n  const projectRoot = schema.directory ?? joinPathFragments('apps', fileName);\n  const parsedTags = schema.tags ? schema.tags.split(',').map((t) => t.trim()) : ['scope:apps'];\n\n  return {\n    name: schema.name,\n    projectName: fileName,\n    projectRoot,\n    className,\n    fileName,\n    propertyName,\n    parsedTags,\n    skipFormat: schema.skipFormat ?? false,\n  };\n}\n"]}
+{"version":3,"file":"normalize-options.js","sourceRoot":"","sources":["../../../../../src/generators/app/lib/normalize-options.ts"],"names":[],"mappings":";;AAqBA,4CAmBC;AAxCD,uCAAiE;AAEjE,sEAA6F;AAmB7F,SAAgB,gBAAgB,CAAC,IAAU,EAAE,MAA0B;IACrE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,0BAAiB,EAAC,MAAM,CAAC,aAAa,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvG,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAA,sCAAmB,EAAC,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACtF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAE9F,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,QAAQ;QACrB,WAAW;QACX,UAAU;QACV,MAAM;QACN,kBAAkB,EAAE,IAAA,wCAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC;QACrE,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,UAAU;QACV,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;KACvC,CAAC;AACJ,CAAC","sourcesContent":["import { type Tree, names, joinPathFragments } from '@nx/devkit';\nimport type { AppGeneratorSchema } from '../schema.js';\nimport { getIgnoreDeprecations, resolveProjectPaths } from '../../../utils/project-paths.js';\n\nexport interface NormalizedAppOptions {\n  name: string;\n  projectName: string;\n  /** Project root relative to the Nx workspace root. */\n  projectRoot: string;\n  /** Where the files are written, relative to the tree root. */\n  outputRoot: string;\n  /** Path from the project back to the workspace root, e.g. `../../`. */\n  offset: string;\n  ignoreDeprecations: string;\n  className: string;\n  fileName: string;\n  propertyName: string;\n  parsedTags: string[];\n  skipFormat: boolean;\n}\n\nexport function normalizeOptions(tree: Tree, schema: AppGeneratorSchema): NormalizedAppOptions {\n  const { className, fileName, propertyName } = names(schema.name);\n  const outputRoot = schema.directory ?? joinPathFragments(schema.workspaceRoot ?? '', 'apps', fileName);\n  const { projectRoot, offset } = resolveProjectPaths(outputRoot, schema.workspaceRoot);\n  const parsedTags = schema.tags ? schema.tags.split(',').map((t) => t.trim()) : ['scope:apps'];\n\n  return {\n    name: schema.name,\n    projectName: fileName,\n    projectRoot,\n    outputRoot,\n    offset,\n    ignoreDeprecations: getIgnoreDeprecations(tree, schema.workspaceRoot),\n    className,\n    fileName,\n    propertyName,\n    parsedTags,\n    skipFormat: schema.skipFormat ?? false,\n  };\n}\n"]}

package/generators/app/schema.d.ts

@@ -1,6 +1,8 @@
 export interface AppGeneratorSchema {
     name: string;
     directory?: string;
+    /** Set when the tree root is above the Nx workspace (the `workspace` generator scaffolds into `<name>/`). */
+    workspaceRoot?: string;
     tags?: string;
     skipFormat?: boolean;
 }

package/generators/app/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/generators/app/schema.ts"],"names":[],"mappings":"","sourcesContent":["export interface AppGeneratorSchema {\n  name: string;\n  directory?: string;\n  tags?: string;\n  skipFormat?: boolean;\n}\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/generators/app/schema.ts"],"names":[],"mappings":"","sourcesContent":["export interface AppGeneratorSchema {\n  name: string;\n  directory?: string;\n  /** Set when the tree root is above the Nx workspace (the `workspace` generator scaffolds into `<name>/`). */\n  workspaceRoot?: string;\n  tags?: string;\n  skipFormat?: boolean;\n}\n"]}

package/generators/app/schema.json

@@ -17,6 +17,11 @@
       "description": "The directory of the application (default: apps/<name>)",
       "x-priority": "important"
     },
+    "workspaceRoot": {
+      "type": "string",
+      "description": "Folder of the Nx workspace when it is not the tree root",
+      "x-priority": "internal"
+    },
     "tags": {
       "type": "string",
       "description": "Comma-separated tags for the project",

package/generators/auth-provider/files/__fileName__.auth-provider.ts__tmpl__

@@ -2,7 +2,6 @@ import { AuthProvider } from '@frontmcp/sdk';
 
 @AuthProvider({
   name: '<%= name %>',
-  type: '<%= authType %>',
 })
 export class <%= className %>AuthProvider {
   async headers(): Promise<Record<string, string>> {

package/generators/flow/files/__fileName__.flow.ts__tmpl__

@@ -1,31 +1,69 @@
-import { Flow, FlowBase } from '@frontmcp/sdk';
+import { Flow, FlowBase, FlowHooksOf, z, type FlowPlan, type FlowRunOptions } from '@frontmcp/sdk';
+
+const name = '<%= name %>' as const;
+
+const inputSchema = z.object({
+  // TODO: describe the flow input
+  value: z.string().default(''),
+});
+
+const outputSchema = z.object({
+  // TODO: describe the flow output
+  result: z.string(),
+});
+
+const stateSchema = z.object({
+  result: z.string().default(''),
+});
+
+const plan = {
+  pre: ['pre'],
+  execute: ['execute'],
+  post: ['post'],
+  finalize: ['finalize'],
+} as const satisfies FlowPlan<string>;
+
+declare global {
+  interface ExtendFlows {
+    [name]: FlowRunOptions<
+      <%= className %>Flow,
+      typeof plan,
+      typeof inputSchema,
+      typeof outputSchema,
+      typeof stateSchema
+    >;
+  }
+}
+
+const { Stage } = FlowHooksOf<typeof name>(name);
 
 @Flow({
-  name: '<%= name %>',
+  name,
   description: 'TODO: describe what this flow does',
-  plan: {
-    steps: ['pre', 'execute', 'post', 'finalize'],
-  },
+  plan,
+  inputSchema,
+  outputSchema,
+  access: 'public',
 })
-export default class <%= className %>Flow extends FlowBase {
-  async pre(): Promise<void> {
+export default class <%= className %>Flow extends FlowBase<typeof name> {
+  @Stage('pre')
+  async pre() {
     // TODO: pre-processing logic
   }
 
-  async execute(): Promise<void> {
+  @Stage('execute')
+  async execute() {
     // TODO: main execution logic
+    this.state.set('result', this.rawInput.value ?? '');
   }
 
-  async post(): Promise<void> {
+  @Stage('post')
+  async post() {
     // TODO: post-processing logic
   }
 
-  async finalize(): Promise<void> {
-    // TODO: finalization logic
-  }
-
-  async error(err: Error): Promise<void> {
-    // TODO: error handling logic
-    throw err;
+  @Stage('finalize')
+  async finalize() {
+    this.respond({ result: this.state.result ?? '' });
   }
 }

package/generators/init/init.d.ts

@@ -0,0 +1,4 @@
+import { type GeneratorCallback, type Tree } from '@nx/devkit';
+import type { InitGeneratorSchema } from './schema.js';
+export declare function initGenerator(tree: Tree, schema?: InitGeneratorSchema): Promise<GeneratorCallback>;
+export default initGenerator;

package/generators/init/init.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initGenerator = initGenerator;
+const devkit_1 = require("@nx/devkit");
+const add_dependencies_js_1 = require("../../utils/add-dependencies.js");
+const versions_js_1 = require("../../utils/versions.js");
+const CACHEABLE_EXECUTORS = ['@frontmcp/nx:build', '@frontmcp/nx:build-exec', '@frontmcp/nx:test'];
+/**
+ * Executors are only cached when the target (or a `targetDefaults` entry for
+ * the executor) says so — Nx does not read that from the plugin itself.
+ */
+function makeExecutorsCacheable(tree) {
+    const nxJson = (0, devkit_1.readNxJson)(tree);
+    if (!nxJson)
+        return;
+    const targetDefaults = nxJson.targetDefaults ?? {};
+    const inputs = nxJson.namedInputs?.['production'] ? ['production', '^production'] : undefined;
+    for (const executor of CACHEABLE_EXECUTORS) {
+        const existing = targetDefaults[executor];
+        targetDefaults[executor] = {
+            cache: true,
+            ...(executor !== '@frontmcp/nx:test' && { dependsOn: ['^build'] }),
+            ...(inputs && { inputs }),
+            ...existing,
+        };
+    }
+    (0, devkit_1.updateNxJson)(tree, { ...nxJson, targetDefaults });
+}
+async function initGenerator(tree, schema = {}) {
+    makeExecutorsCacheable(tree);
+    const installTask = schema.skipPackageJson
+        ? () => undefined
+        : (0, add_dependencies_js_1.addFrontmcpDependencies)(tree, { ...(0, versions_js_1.getFrontmcpDependencies)(), tslib: '^2.3.0' }, { ...(0, versions_js_1.getFrontmcpDevDependencies)(), ...(0, versions_js_1.getJestDevDependencies)() }, { keepExistingVersions: true });
+    if (!schema.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    return installTask;
+}
+exports.default = initGenerator;
+//# sourceMappingURL=init.js.map

package/generators/init/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/generators/init/init.ts"],"names":[],"mappings":";;AAgCA,sCAiBC;AAjDD,uCAAsG;AAEtG,yEAA0E;AAC1E,yDAAsH;AAGtH,MAAM,mBAAmB,GAAG,CAAC,oBAAoB,EAAE,yBAAyB,EAAE,mBAAmB,CAAU,CAAC;AAE5G;;;GAGG;AACH,SAAS,sBAAsB,CAAC,IAAU;IACxC,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9F,KAAK,MAAM,QAAQ,IAAI,mBAAmB,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC1C,cAAc,CAAC,QAAQ,CAAC,GAAG;YACzB,KAAK,EAAE,IAAI;YACX,GAAG,CAAC,QAAQ,KAAK,mBAAmB,IAAI,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC;YACzB,GAAG,QAAQ;SACZ,CAAC;IACJ,CAAC;IAED,IAAA,qBAAY,EAAC,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AACpD,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,IAAU,EAAE,SAA8B,EAAE;IAC9E,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe;QACxC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS;QACjB,CAAC,CAAC,IAAA,6CAAuB,EACrB,IAAI,EACJ,EAAE,GAAG,IAAA,qCAAuB,GAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EACjD,EAAE,GAAG,IAAA,wCAA0B,GAAE,EAAE,GAAG,IAAA,oCAAsB,GAAE,EAAE,EAChE,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAC/B,CAAC;IAEN,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,kBAAe,aAAa,CAAC","sourcesContent":["import { formatFiles, readNxJson, updateNxJson, type GeneratorCallback, type Tree } from '@nx/devkit';\n\nimport { addFrontmcpDependencies } from '../../utils/add-dependencies.js';\nimport { getFrontmcpDependencies, getFrontmcpDevDependencies, getJestDevDependencies } from '../../utils/versions.js';\nimport type { InitGeneratorSchema } from './schema.js';\n\nconst CACHEABLE_EXECUTORS = ['@frontmcp/nx:build', '@frontmcp/nx:build-exec', '@frontmcp/nx:test'] as const;\n\n/**\n * Executors are only cached when the target (or a `targetDefaults` entry for\n * the executor) says so — Nx does not read that from the plugin itself.\n */\nfunction makeExecutorsCacheable(tree: Tree): void {\n  const nxJson = readNxJson(tree);\n  if (!nxJson) return;\n\n  const targetDefaults = nxJson.targetDefaults ?? {};\n  const inputs = nxJson.namedInputs?.['production'] ? ['production', '^production'] : undefined;\n\n  for (const executor of CACHEABLE_EXECUTORS) {\n    const existing = targetDefaults[executor];\n    targetDefaults[executor] = {\n      cache: true,\n      ...(executor !== '@frontmcp/nx:test' && { dependsOn: ['^build'] }),\n      ...(inputs && { inputs }),\n      ...existing,\n    };\n  }\n\n  updateNxJson(tree, { ...nxJson, targetDefaults });\n}\n\nexport async function initGenerator(tree: Tree, schema: InitGeneratorSchema = {}): Promise<GeneratorCallback> {\n  makeExecutorsCacheable(tree);\n\n  const installTask = schema.skipPackageJson\n    ? () => undefined\n    : addFrontmcpDependencies(\n        tree,\n        { ...getFrontmcpDependencies(), tslib: '^2.3.0' },\n        { ...getFrontmcpDevDependencies(), ...getJestDevDependencies() },\n        { keepExistingVersions: true },\n      );\n\n  if (!schema.skipFormat) {\n    await formatFiles(tree);\n  }\n\n  return installTask;\n}\n\nexport default initGenerator;\n"]}

package/generators/init/schema.d.ts

@@ -0,0 +1,4 @@
+export interface InitGeneratorSchema {
+    skipPackageJson?: boolean;
+    skipFormat?: boolean;
+}

package/generators/init/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/generators/init/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/generators/init/schema.ts"],"names":[],"mappings":"","sourcesContent":["export interface InitGeneratorSchema {\n  skipPackageJson?: boolean;\n  skipFormat?: boolean;\n}\n"]}

package/generators/init/schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "FrontMcpInit",
+  "title": "FrontMCP Init Generator",
+  "description": "Prepare an existing Nx workspace for FrontMCP: install the FrontMCP packages and make the executors cacheable",
+  "type": "object",
+  "properties": {
+    "skipPackageJson": {
+      "type": "boolean",
+      "description": "Do not add FrontMCP dependencies to package.json",
+      "default": false
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "required": []
+}

package/generators/lib/lib/normalize-options.d.ts

@@ -1,8 +1,11 @@
+import { type Tree } from '@nx/devkit';
 import type { LibGeneratorSchema } from '../schema.js';
 export interface NormalizedLibOptions {
     name: string;
     projectName: string;
     projectRoot: string;
+    offset: string;
+    ignoreDeprecations: string;
     className: string;
     fileName: string;
     propertyName: string;
@@ -12,4 +15,4 @@ export interface NormalizedLibOptions {
     parsedTags: string[];
     skipFormat: boolean;
 }
-export declare function normalizeOptions(schema: LibGeneratorSchema): NormalizedLibOptions;
+export declare function normalizeOptions(tree: Tree, schema: LibGeneratorSchema): NormalizedLibOptions;

package/generators/lib/lib/normalize-options.js

@@ -2,9 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeOptions = normalizeOptions;
 const devkit_1 = require("@nx/devkit");
-function normalizeOptions(schema) {
+const project_paths_js_1 = require("../../../utils/project-paths.js");
+function normalizeOptions(tree, schema) {
     const { className, fileName, propertyName } = (0, devkit_1.names)(schema.name);
-    const projectRoot = schema.directory ?? (0, devkit_1.joinPathFragments)('libs', fileName);
+    const { projectRoot, offset } = (0, project_paths_js_1.resolveProjectPaths)(schema.directory ?? (0, devkit_1.joinPathFragments)('libs', fileName));
     const libType = schema.libType ?? 'generic';
     const publishable = schema.publishable ?? false;
     const importPath = schema.importPath ?? `@frontmcp/${fileName}`;
@@ -18,6 +19,8 @@ function normalizeOptions(schema) {
         name: schema.name,
         projectName: fileName,
         projectRoot,
+        offset,
+        ignoreDeprecations: (0, project_paths_js_1.getIgnoreDeprecations)(tree),
         className,
         fileName,
         propertyName,

package/generators/lib/lib/normalize-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-options.js","sourceRoot":"","sources":["../../../../../src/generators/lib/lib/normalize-options.ts"],"names":[],"mappings":";;AAiBA,4CA2BC;AA5CD,uCAAsD;AAiBtD,SAAgB,gBAAgB,CAAC,MAA0B;IACzD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,0BAAiB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC;IAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,aAAa,QAAQ,EAAE,CAAC;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI;QAC5B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAEnB,IAAI,WAAW,EAAE,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,QAAQ;QACrB,WAAW;QACX,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,WAAW;QACX,UAAU;QACV,UAAU;QACV,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;KACvC,CAAC;AACJ,CAAC","sourcesContent":["import { names, joinPathFragments } from '@nx/devkit';\nimport type { LibGeneratorSchema } from '../schema.js';\n\nexport interface NormalizedLibOptions {\n  name: string;\n  projectName: string;\n  projectRoot: string;\n  className: string;\n  fileName: string;\n  propertyName: string;\n  libType: 'generic' | 'plugin' | 'adapter' | 'tool-register';\n  publishable: boolean;\n  importPath: string;\n  parsedTags: string[];\n  skipFormat: boolean;\n}\n\nexport function normalizeOptions(schema: LibGeneratorSchema): NormalizedLibOptions {\n  const { className, fileName, propertyName } = names(schema.name);\n  const projectRoot = schema.directory ?? joinPathFragments('libs', fileName);\n  const libType = schema.libType ?? 'generic';\n  const publishable = schema.publishable ?? false;\n  const importPath = schema.importPath ?? `@frontmcp/${fileName}`;\n  const parsedTags = schema.tags\n    ? schema.tags.split(',').map((t) => t.trim())\n    : ['scope:libs'];\n\n  if (publishable) {\n    parsedTags.push('scope:publishable');\n  }\n\n  return {\n    name: schema.name,\n    projectName: fileName,\n    projectRoot,\n    className,\n    fileName,\n    propertyName,\n    libType,\n    publishable,\n    importPath,\n    parsedTags,\n    skipFormat: schema.skipFormat ?? false,\n  };\n}\n"]}
+{"version":3,"file":"normalize-options.js","sourceRoot":"","sources":["../../../../../src/generators/lib/lib/normalize-options.ts"],"names":[],"mappings":";;AAoBA,4CA6BC;AAjDD,uCAAiE;AAEjE,sEAA6F;AAkB7F,SAAgB,gBAAgB,CAAC,IAAU,EAAE,MAA0B;IACrE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAA,sCAAmB,EAAC,MAAM,CAAC,SAAS,IAAI,IAAA,0BAAiB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7G,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC;IAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,aAAa,QAAQ,EAAE,CAAC;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI;QAC5B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAEnB,IAAI,WAAW,EAAE,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,QAAQ;QACrB,WAAW;QACX,MAAM;QACN,kBAAkB,EAAE,IAAA,wCAAqB,EAAC,IAAI,CAAC;QAC/C,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,WAAW;QACX,UAAU;QACV,UAAU;QACV,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;KACvC,CAAC;AACJ,CAAC","sourcesContent":["import { type Tree, names, joinPathFragments } from '@nx/devkit';\nimport type { LibGeneratorSchema } from '../schema.js';\nimport { getIgnoreDeprecations, resolveProjectPaths } from '../../../utils/project-paths.js';\n\nexport interface NormalizedLibOptions {\n  name: string;\n  projectName: string;\n  projectRoot: string;\n  offset: string;\n  ignoreDeprecations: string;\n  className: string;\n  fileName: string;\n  propertyName: string;\n  libType: 'generic' | 'plugin' | 'adapter' | 'tool-register';\n  publishable: boolean;\n  importPath: string;\n  parsedTags: string[];\n  skipFormat: boolean;\n}\n\nexport function normalizeOptions(tree: Tree, schema: LibGeneratorSchema): NormalizedLibOptions {\n  const { className, fileName, propertyName } = names(schema.name);\n  const { projectRoot, offset } = resolveProjectPaths(schema.directory ?? joinPathFragments('libs', fileName));\n  const libType = schema.libType ?? 'generic';\n  const publishable = schema.publishable ?? false;\n  const importPath = schema.importPath ?? `@frontmcp/${fileName}`;\n  const parsedTags = schema.tags\n    ? schema.tags.split(',').map((t) => t.trim())\n    : ['scope:libs'];\n\n  if (publishable) {\n    parsedTags.push('scope:publishable');\n  }\n\n  return {\n    name: schema.name,\n    projectName: fileName,\n    projectRoot,\n    offset,\n    ignoreDeprecations: getIgnoreDeprecations(tree),\n    className,\n    fileName,\n    propertyName,\n    libType,\n    publishable,\n    importPath,\n    parsedTags,\n    skipFormat: schema.skipFormat ?? false,\n  };\n}\n"]}

package/generators/lib/lib-project-files/jest.config.cjs__tmpl__

@@ -0,0 +1,39 @@
+const { join } = require('path');
+const ts = require('typescript');
+
+// Mirror the tsconfig.base.json path aliases so imports across projects (e.g. `@scope/lib`) resolve in tests.
+const workspaceRoot = join(__dirname, '<%= offset %>');
+const { config: baseConfig } = ts.readConfigFile(join(workspaceRoot, 'tsconfig.base.json'), ts.sys.readFile);
+const aliases = (baseConfig && baseConfig.compilerOptions && baseConfig.compilerOptions.paths) || {};
+const moduleNameMapper = Object.fromEntries(
+  Object.entries(aliases).map(([alias, [target]]) => [
+    '^' + alias.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace('*', '(.*)') + '$',
+    join(workspaceRoot, target).replace('*', '$1'),
+  ]),
+);
+
+module.exports = {
+  displayName: '<%= projectName %>',
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.[tj]s$': ['@swc/jest', {
+      jsc: {
+        target: 'es2022',
+        parser: { syntax: 'typescript', decorators: true, dynamicImport: true },
+        transform: { decoratorMetadata: true, legacyDecorator: true },
+        keepClassNames: true,
+        externalHelpers: true,
+        loose: true,
+      },
+      sourceMaps: true,
+      swcrc: false,
+    }],
+  },
+  setupFilesAfterEnv: ['@frontmcp/testing/setup'],
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  moduleNameMapper,
+  // Transpile ESM-only deps; the `.pnpm` skip keeps this correct under pnpm (issue #519).
+  transformIgnorePatterns: ['node_modules[/\\\\](?!\\.pnpm[/\\\\])(?!(jose)[/\\\\])'],
+  coverageDirectory: '<%= offset %>coverage/unit/<%= projectName %>',
+  collectCoverageFrom: ['src/**/*.ts', '!src/**/*.d.ts', '!src/**/index.ts'],
+};

package/generators/lib/lib-project-files/project.json__tmpl__

@@ -0,0 +1,16 @@
+{
+  "name": "<%= projectName %>",
+  "$schema": "<%= offset %>node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "<%= projectRoot %>/src",
+  "projectType": "library",
+  "tags": [<%- parsedTags.map(t => `"${t}"`).join(', ') %>],
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
+      "options": {
+        "jestConfig": "<%= projectRoot %>/jest.config.cjs"
+      }
+    }
+  }
+}

package/generators/lib/lib-project-files/tsconfig.json__tmpl__

@@ -0,0 +1,15 @@
+{
+  "extends": "<%= offset %>tsconfig.base.json",
+  "compilerOptions": {
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    { "path": "./tsconfig.lib.json" },
+    { "path": "./tsconfig.spec.json" }
+  ]
+}

package/generators/lib/lib-project-files/tsconfig.lib.json__tmpl__

@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/**/*.spec.ts", "src/**/*.test.ts"]
+}