@mistralys/persona-builder 2.3.0 → 2.4.1

package/dist/index.cjs

@@ -157,7 +157,7 @@ function runBuildContext(plugins, ctx, persona, suite, target) {
   let accumulated = ctx;
   for (const plugin of plugins) {
     if (typeof plugin.onBuildContext === "function") {
-      accumulated = plugin.onBuildContext(accumulated, persona, suite, target);
+      accumulated = plugin.onBuildContext(accumulated, persona, suite, target) ?? accumulated;
     }
   }
   return accumulated;
@@ -166,11 +166,29 @@ function runPostRender(plugins, rendered, persona, target) {
   let output = rendered;
   for (const plugin of plugins) {
     if (typeof plugin.onPostRender === "function") {
-      output = plugin.onPostRender(output, persona, target);
+      output = plugin.onPostRender(output, persona, target) ?? output;
     }
   }
   return output;
 }
+function runPartials(plugins, partialsMap, suiteName, suite) {
+  let accumulated = partialsMap;
+  for (const plugin of plugins) {
+    if (typeof plugin.onPartials === "function") {
+      accumulated = plugin.onPartials(accumulated, suiteName, suite) ?? accumulated;
+    }
+  }
+  return accumulated;
+}
+function runPersonaPartials(plugins, partialsMap, persona, context, suite, target) {
+  let accumulated = partialsMap;
+  for (const plugin of plugins) {
+    if (typeof plugin.onPersonaPartials === "function") {
+      accumulated = plugin.onPersonaPartials(accumulated, persona, context, suite, target) ?? accumulated;
+    }
+  }
+  return accumulated;
+}
 function runValidate(plugins, persona, suite, target) {
   const results = [];
   for (const plugin of plugins) {
@@ -393,9 +411,20 @@ async function buildAgentNameMap(config) {
   }
   return agentMap;
 }
-function buildContext(personaMeta, sharedMeta, agentMap = {}, target, registry) {
+function buildContext(options) {
+  const {
+    personaMeta,
+    sharedMeta,
+    agentMap = {},
+    target,
+    registry,
+    configVariables,
+    suiteVariables
+  } = options;
   const version = typeof personaMeta["version"] === "string" ? personaMeta["version"] : typeof sharedMeta["default_version"] === "string" ? sharedMeta["default_version"] : "0.0.0";
   const merged = {
+    ...configVariables ?? {},
+    ...suiteVariables ?? {},
     ...sharedMeta,
     ...personaMeta,
     version
@@ -448,18 +477,49 @@ function buildContext(personaMeta, sharedMeta, agentMap = {}, target, registry)
   }
   return merged;
 }
+function validateSubagentRefs(persona, agentMap) {
+  const subagents = persona.subagents;
+  if (!Array.isArray(subagents) || subagents.length === 0) return [];
+  const results = [];
+  for (const slug of subagents) {
+    const key = `agent_slug_${slug.replace(/-/g, "_")}`;
+    if (!(key in agentMap)) {
+      results.push({
+        severity: "error",
+        message: `Persona '${persona.name}' declares subagent '${slug}' but no persona with that slug exists in any configured suite.`
+      });
+    }
+  }
+  return results;
+}
 async function buildPersona(personaYamlPath, suiteName, suiteConfig, sharedMeta, partialsMap, config, plugins, target, agentMap = {}, registry = defaultRegistry) {
   const personaMeta = await loadPersonaYaml(personaYamlPath);
-  let context = buildContext(personaMeta, sharedMeta, agentMap, target, registry);
+  let context = buildContext({
+    personaMeta,
+    sharedMeta,
+    agentMap,
+    target,
+    registry,
+    configVariables: config.variables,
+    suiteVariables: suiteConfig.variables
+  });
   const personaMetaTyped = personaMeta;
   context = runBuildContext(plugins, context, personaMetaTyped, suiteConfig, target);
+  const personaPartialsMap = runPersonaPartials(
+    plugins,
+    { ...partialsMap },
+    personaMetaTyped,
+    context,
+    suiteConfig,
+    target
+  );
   const fmTemplate = resolveFrontmatterTemplate(target, plugins, config.frontmatter, registry);
   const contentBasename = path4__default.default.basename(personaYamlPath, ".yaml") + ".md";
   const frontmatter = renderFrontmatter(fmTemplate, context, contentBasename);
   const contentSubdir = suiteConfig.contentSubdir ?? "content";
   const contentPath = path4__default.default.join(suiteConfig.srcDir, contentSubdir, contentBasename);
   const bodyTemplate = normalizeNewlines(await promises.readFile(contentPath, "utf8"));
-  let body = resolvePartials(bodyTemplate, partialsMap);
+  let body = resolvePartials(bodyTemplate, personaPartialsMap);
   body = resolveConditionals(body, context);
   body = resolveVariables(body, context, contentBasename);
   body = collapseBlankLines(body);
@@ -470,7 +530,10 @@ async function buildPersona(personaYamlPath, suiteName, suiteConfig, sharedMeta,
 ${body}
 `);
   output = runPostRender(plugins, output, personaMetaTyped, target);
-  const validationResults = runValidate(plugins, personaMetaTyped, suiteConfig, target);
+  const validationResults = [
+    ...runValidate(plugins, personaMetaTyped, suiteConfig, target),
+    ...validateSubagentRefs(personaMetaTyped, agentMap)
+  ];
   const def = registry.has(target) ? registry.get(target) : void 0;
   const outputDir = resolveOutputDir(target, suiteConfig, def);
   const fnKey = def?.filenameContextKey;
@@ -497,7 +560,7 @@ async function buildSuite(suiteName, suiteConfig, config, plugins, target, agent
   const metaSubdir = suiteConfig.metaSubdir ?? "meta";
   const sharedYamlPath = path4__default.default.join(suiteConfig.srcDir, metaSubdir, "_shared.yaml");
   const sharedMeta = await loadRawYaml(sharedYamlPath);
-  let partialsMap = {};
+  let partialsMap = { ...config.partials ?? {} };
   if (config.sharedPartialsDir && fs.existsSync(config.sharedPartialsDir)) {
     partialsMap = { ...partialsMap, ...await loadPartials(config.sharedPartialsDir) };
   }
@@ -507,6 +570,7 @@ async function buildSuite(suiteName, suiteConfig, config, plugins, target, agent
     partialsMap = { ...partialsMap, ...await loadPartials(suitePartialsDir) };
   }
   runSuiteInit(plugins, suiteConfig, sharedMeta);
+  partialsMap = runPartials(plugins, partialsMap, suiteName, suiteConfig);
   const personaYamlPaths = await discoverSuitePersonaYamls(suiteConfig);
   const results = [];
   for (const yamlPath of personaYamlPaths) {
@@ -648,6 +712,8 @@ exports.resolveFrontmatterTemplate = resolveFrontmatterTemplate;
 exports.resolvePartials = resolvePartials;
 exports.resolveVariables = resolveVariables;
 exports.runBuildContext = runBuildContext;
+exports.runPartials = runPartials;
+exports.runPersonaPartials = runPersonaPartials;
 exports.runPostRender = runPostRender;
 exports.runSuiteInit = runSuiteInit;
 exports.runValidate = runValidate;