@mistralys/persona-builder 2.4.1 → 2.5.1

package/dist/index.d.cts

@@ -86,7 +86,7 @@ declare function resolveConditionals(text: string, context: Record<string, unkno
  * variables.ts
  *
  * Pure template-engine function for resolving variable substitutions.
- * Handles {{varName}} syntax. No file-system I/O.
+ * Handles {{varName}} substitution and \{{varName}} escape syntax. No file-system I/O.
  */
 /**
  * Resolve variable substitutions in a template string.
@@ -96,6 +96,10 @@ declare function resolveConditionals(text: string, context: Record<string, unkno
  * the original marker is preserved and a warning is emitted via
  * `console.warn`, identifying the file by `filename` for easier debugging.
  *
+ * **Escape syntax:** prefix a marker with a backslash (`\{{varName}}`) to
+ * emit the literal `{{varName}}` text in the output without performing any
+ * lookup or triggering an unresolved-variable warning.
+ *
  * Note: this step must run AFTER `resolvePartials` and `resolveConditionals`
  * so that only plain variable markers remain.
  *
@@ -179,6 +183,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
@@ -748,7 +772,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.
  *
@@ -1316,4 +1340,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

@@ -86,7 +86,7 @@ declare function resolveConditionals(text: string, context: Record<string, unkno
  * variables.ts
  *
  * Pure template-engine function for resolving variable substitutions.
- * Handles {{varName}} syntax. No file-system I/O.
+ * Handles {{varName}} substitution and \{{varName}} escape syntax. No file-system I/O.
  */
 /**
  * Resolve variable substitutions in a template string.
@@ -96,6 +96,10 @@ declare function resolveConditionals(text: string, context: Record<string, unkno
  * the original marker is preserved and a warning is emitted via
  * `console.warn`, identifying the file by `filename` for easier debugging.
  *
+ * **Escape syntax:** prefix a marker with a backslash (`\{{varName}}`) to
+ * emit the literal `{{varName}}` text in the output without performing any
+ * lookup or triggering an unresolved-variable warning.
+ *
  * Note: this step must run AFTER `resolvePartials` and `resolveConditionals`
  * so that only plain variable markers remain.
  *
@@ -179,6 +183,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
@@ -748,7 +772,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.
  *
@@ -1316,4 +1340,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

@@ -65,7 +65,10 @@ function resolveConditionals(text, context) {
 
 // src/engine/variables.ts
 function resolveVariables(text, context, filename) {
-  return text.replace(/\{\{(\w+)\}\}/g, (match, varName) => {
+  return text.replace(/(\\?)\{\{(\w+)\}\}/g, (match, escape, varName) => {
+    if (escape === "\\") {
+      return `{{${varName}}}`;
+    }
     if (varName in context && context[varName] !== void 0) {
       return String(context[varName]);
     }
@@ -95,6 +98,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 +210,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 +442,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 +464,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)) {
@@ -678,6 +694,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