@mistralys/persona-builder 2.4.0 → 2.5.0

package/dist/index.d.cts

@@ -179,6 +179,26 @@ declare function serializeTools(tools: string[]): string;
  * serializeToolsList([])              // => ""
  */
 declare function serializeToolsList(tools: string[]): string;
+/**
+ * Serialize a tools array as a YAML block sequence.
+ *
+ * Output format (non-empty):
+ *   `\n  - tool1\n  - tool2`
+ *
+ * Output format (empty):
+ *   ` []`
+ *
+ * Designed for use in frontmatter templates as `tools:{{tools_block}}`
+ * (no space between the colon and the variable).
+ *
+ * @param tools - Array of tool name strings
+ * @returns     YAML block sequence string (includes leading newline for non-empty arrays)
+ *
+ * @example
+ * serializeToolsBlock(['Bash', 'Read']) // => "\n  - Bash\n  - Read"
+ * serializeToolsBlock([])              // => " []"
+ */
+declare function serializeToolsBlock(tools: string[]): string;
 
 /**
  * src/loaders/partials-loader.ts
@@ -256,6 +276,14 @@ interface PersonaMetadata {
     version?: string;
     /** Ordered list of tool identifiers */
     tools?: string[];
+    /**
+     * Optional list of persona slugs this persona delegates to as sub-agents.
+     *
+     * Each entry is a kebab-case slug referencing another persona in any
+     * configured suite. Validated during build against the cross-suite agent
+     * map — an unknown slug produces an error-severity `ValidationResult`.
+     */
+    subagents?: string[];
     /** Free-form context variables available during template rendering */
     [key: string]: unknown;
 }
@@ -740,7 +768,7 @@ declare const DEFAULT_FRONTMATTER_VSCODE = "---\nname: '{{name}} v{{version}}'\n
  * Minimal fields that work for standalone personas. Projects using numbered
  * workflows should inject a richer template via a plugin.
  */
-declare const DEFAULT_FRONTMATTER_CLAUDE_CODE = "---\nname: {{cc_file_name_stem}}\npermissionMode: {{cc_permission_mode}}\nmodel: {{cc_model}}\nmemory: {{cc_memory}}\nallowedTools: [{{cc_tools_list}}]\n---";
+declare const DEFAULT_FRONTMATTER_CLAUDE_CODE = "---\nname: {{cc_file_name_stem}}\ndescription: {{description}}\nmodel: {{cc_model}}\nmemory: {{cc_memory}}\ntools:{{cc_tools_block}}\n---";
 /**
  * Default Deep Agents frontmatter template.
  *
@@ -1308,4 +1336,4 @@ declare const defaultRegistry: TargetRegistry;
 
 declare const VERSION: string;
 
-export { type BuildConfig, type BuildResult, type BuildSummary, DEFAULT_FRONTMATTER_CLAUDE_CODE, DEFAULT_FRONTMATTER_DEEP_AGENTS, DEFAULT_FRONTMATTER_VSCODE, type PersonaBuildPlugin, type PersonaMetadata, type SuiteConfig, TARGET_CLAUDE_CODE, TARGET_DEEP_AGENTS, TARGET_VSCODE, type TargetDefinition, TargetRegistry, type TargetType, VERSION, type ValidationResult, build, buildPersona, buildSuite, collapseBlankLines, defaultRegistry, discoverPersonaYamls, ensureBlankLineBeforeHeadings, escapeRegExp, loadContent, loadMetadata, loadPartials, normalizeNewlines, renderFrontmatter, resolveConditionals, resolveFrontmatterTemplate, resolvePartials, resolveVariables, runBuildContext, runPartials, runPersonaPartials, runPostRender, runSuiteInit, runValidate, serializeTools, serializeToolsList, validateFileName, validateStrictMarkers };
+export { type BuildConfig, type BuildResult, type BuildSummary, DEFAULT_FRONTMATTER_CLAUDE_CODE, DEFAULT_FRONTMATTER_DEEP_AGENTS, DEFAULT_FRONTMATTER_VSCODE, type PersonaBuildPlugin, type PersonaMetadata, type SuiteConfig, TARGET_CLAUDE_CODE, TARGET_DEEP_AGENTS, TARGET_VSCODE, type TargetDefinition, TargetRegistry, type TargetType, VERSION, type ValidationResult, build, buildPersona, buildSuite, collapseBlankLines, defaultRegistry, discoverPersonaYamls, ensureBlankLineBeforeHeadings, escapeRegExp, loadContent, loadMetadata, loadPartials, normalizeNewlines, renderFrontmatter, resolveConditionals, resolveFrontmatterTemplate, resolvePartials, resolveVariables, runBuildContext, runPartials, runPersonaPartials, runPostRender, runSuiteInit, runValidate, serializeTools, serializeToolsBlock, serializeToolsList, validateFileName, validateStrictMarkers };

package/dist/index.d.ts

@@ -179,6 +179,26 @@ declare function serializeTools(tools: string[]): string;
  * serializeToolsList([])              // => ""
  */
 declare function serializeToolsList(tools: string[]): string;
+/**
+ * Serialize a tools array as a YAML block sequence.
+ *
+ * Output format (non-empty):
+ *   `\n  - tool1\n  - tool2`
+ *
+ * Output format (empty):
+ *   ` []`
+ *
+ * Designed for use in frontmatter templates as `tools:{{tools_block}}`
+ * (no space between the colon and the variable).
+ *
+ * @param tools - Array of tool name strings
+ * @returns     YAML block sequence string (includes leading newline for non-empty arrays)
+ *
+ * @example
+ * serializeToolsBlock(['Bash', 'Read']) // => "\n  - Bash\n  - Read"
+ * serializeToolsBlock([])              // => " []"
+ */
+declare function serializeToolsBlock(tools: string[]): string;
 
 /**
  * src/loaders/partials-loader.ts
@@ -256,6 +276,14 @@ interface PersonaMetadata {
     version?: string;
     /** Ordered list of tool identifiers */
     tools?: string[];
+    /**
+     * Optional list of persona slugs this persona delegates to as sub-agents.
+     *
+     * Each entry is a kebab-case slug referencing another persona in any
+     * configured suite. Validated during build against the cross-suite agent
+     * map — an unknown slug produces an error-severity `ValidationResult`.
+     */
+    subagents?: string[];
     /** Free-form context variables available during template rendering */
     [key: string]: unknown;
 }
@@ -740,7 +768,7 @@ declare const DEFAULT_FRONTMATTER_VSCODE = "---\nname: '{{name}} v{{version}}'\n
  * Minimal fields that work for standalone personas. Projects using numbered
  * workflows should inject a richer template via a plugin.
  */
-declare const DEFAULT_FRONTMATTER_CLAUDE_CODE = "---\nname: {{cc_file_name_stem}}\npermissionMode: {{cc_permission_mode}}\nmodel: {{cc_model}}\nmemory: {{cc_memory}}\nallowedTools: [{{cc_tools_list}}]\n---";
+declare const DEFAULT_FRONTMATTER_CLAUDE_CODE = "---\nname: {{cc_file_name_stem}}\ndescription: {{description}}\nmodel: {{cc_model}}\nmemory: {{cc_memory}}\ntools:{{cc_tools_block}}\n---";
 /**
  * Default Deep Agents frontmatter template.
  *
@@ -1308,4 +1336,4 @@ declare const defaultRegistry: TargetRegistry;
 
 declare const VERSION: string;
 
-export { type BuildConfig, type BuildResult, type BuildSummary, DEFAULT_FRONTMATTER_CLAUDE_CODE, DEFAULT_FRONTMATTER_DEEP_AGENTS, DEFAULT_FRONTMATTER_VSCODE, type PersonaBuildPlugin, type PersonaMetadata, type SuiteConfig, TARGET_CLAUDE_CODE, TARGET_DEEP_AGENTS, TARGET_VSCODE, type TargetDefinition, TargetRegistry, type TargetType, VERSION, type ValidationResult, build, buildPersona, buildSuite, collapseBlankLines, defaultRegistry, discoverPersonaYamls, ensureBlankLineBeforeHeadings, escapeRegExp, loadContent, loadMetadata, loadPartials, normalizeNewlines, renderFrontmatter, resolveConditionals, resolveFrontmatterTemplate, resolvePartials, resolveVariables, runBuildContext, runPartials, runPersonaPartials, runPostRender, runSuiteInit, runValidate, serializeTools, serializeToolsList, validateFileName, validateStrictMarkers };
+export { type BuildConfig, type BuildResult, type BuildSummary, DEFAULT_FRONTMATTER_CLAUDE_CODE, DEFAULT_FRONTMATTER_DEEP_AGENTS, DEFAULT_FRONTMATTER_VSCODE, type PersonaBuildPlugin, type PersonaMetadata, type SuiteConfig, TARGET_CLAUDE_CODE, TARGET_DEEP_AGENTS, TARGET_VSCODE, type TargetDefinition, TargetRegistry, type TargetType, VERSION, type ValidationResult, build, buildPersona, buildSuite, collapseBlankLines, defaultRegistry, discoverPersonaYamls, ensureBlankLineBeforeHeadings, escapeRegExp, loadContent, loadMetadata, loadPartials, normalizeNewlines, renderFrontmatter, resolveConditionals, resolveFrontmatterTemplate, resolvePartials, resolveVariables, runBuildContext, runPartials, runPersonaPartials, runPostRender, runSuiteInit, runValidate, serializeTools, serializeToolsBlock, serializeToolsList, validateFileName, validateStrictMarkers };

package/dist/index.js

@@ -95,6 +95,10 @@ function serializeTools(tools) {
 function serializeToolsList(tools) {
   return tools.map((t) => `'${t}'`).join(", ");
 }
+function serializeToolsBlock(tools) {
+  if (tools.length === 0) return " []";
+  return "\n" + tools.map((t) => `  - ${t}`).join("\n");
+}
 async function loadPartials(dir) {
   const entries = await readdir(dir, { withFileTypes: true });
   const mdFiles = entries.filter(
@@ -203,10 +207,10 @@ tools: [{{tools_list}}]
 ---`;
 var DEFAULT_FRONTMATTER_CLAUDE_CODE = `---
 name: {{cc_file_name_stem}}
-permissionMode: {{cc_permission_mode}}
+description: {{description}}
 model: {{cc_model}}
 memory: {{cc_memory}}
-allowedTools: [{{cc_tools_list}}]
+tools:{{cc_tools_block}}
 ---`;
 var DEFAULT_FRONTMATTER_DEEP_AGENTS = `---
 name: {{name}}
@@ -435,6 +439,12 @@ function buildContext(options) {
   if (!("cc_tools_json" in merged)) {
     merged["cc_tools_json"] = serializeTools(ccTools);
   }
+  if (!("tools_block" in merged)) {
+    merged["tools_block"] = serializeToolsBlock(tools);
+  }
+  if (!("cc_tools_block" in merged)) {
+    merged["cc_tools_block"] = serializeToolsBlock(ccTools);
+  }
   if (!("cc_file_name_stem" in merged) && typeof merged["cc_file_name"] === "string") {
     const ccFileName = merged["cc_file_name"];
     merged["cc_file_name_stem"] = ccFileName.replace(/\.md$/, "");
@@ -451,6 +461,9 @@ function buildContext(options) {
     if (!("da_tools_json" in merged)) {
       merged["da_tools_json"] = serializeTools(daTools);
     }
+    if (!("da_tools_block" in merged)) {
+      merged["da_tools_block"] = serializeToolsBlock(daTools);
+    }
   }
   for (const [key, value] of Object.entries(agentMap)) {
     if (!(key in merged)) {
@@ -469,6 +482,21 @@ function buildContext(options) {
   }
   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({
@@ -507,7 +535,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;
@@ -660,6 +691,6 @@ function escapeRegExp(str) {
 var _pkgRequire = createRequire(import.meta.url);
 var VERSION = _pkgRequire("../package.json").version;
 
-export { DEFAULT_FRONTMATTER_CLAUDE_CODE, DEFAULT_FRONTMATTER_DEEP_AGENTS, DEFAULT_FRONTMATTER_VSCODE, TARGET_CLAUDE_CODE, TARGET_DEEP_AGENTS, TARGET_VSCODE, TargetRegistry, VERSION, build, buildPersona, buildSuite, collapseBlankLines, defaultRegistry, discoverPersonaYamls, ensureBlankLineBeforeHeadings, escapeRegExp, loadContent, loadMetadata, loadPartials, normalizeNewlines, renderFrontmatter, resolveConditionals, resolveFrontmatterTemplate, resolvePartials, resolveVariables, runBuildContext, runPartials, runPersonaPartials, runPostRender, runSuiteInit, runValidate, serializeTools, serializeToolsList, validateFileName, validateStrictMarkers };
+export { DEFAULT_FRONTMATTER_CLAUDE_CODE, DEFAULT_FRONTMATTER_DEEP_AGENTS, DEFAULT_FRONTMATTER_VSCODE, TARGET_CLAUDE_CODE, TARGET_DEEP_AGENTS, TARGET_VSCODE, TargetRegistry, VERSION, build, buildPersona, buildSuite, collapseBlankLines, defaultRegistry, discoverPersonaYamls, ensureBlankLineBeforeHeadings, escapeRegExp, loadContent, loadMetadata, loadPartials, normalizeNewlines, renderFrontmatter, resolveConditionals, resolveFrontmatterTemplate, resolvePartials, resolveVariables, runBuildContext, runPartials, runPersonaPartials, runPostRender, runSuiteInit, runValidate, serializeTools, serializeToolsBlock, serializeToolsList, validateFileName, validateStrictMarkers };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map