@vertesia/studio-utils 1.5.0 → 1.5.1

package/lib/prompts/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/prompts/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,KAAK,gBAAgB,EAAwB,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGlH,MAAM,WAAW,cAAc;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CASpH;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,GACjB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOxE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,GACjB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOxE;AAqCD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE,CAU/G;AAED,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,EAC5C,YAAY,EAAE,MAAM,GAAG,UAAU,GAClC,cAAc,EAAE,CAsBlB;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,GAAG,aAAa,EAAE,CAwB/G"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/prompts/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,KAAK,gBAAgB,EAAwB,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClH,OAAO,EAIH,KAAK,qBAAqB,EAE7B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,YAAY,EACzB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,qBAAqB,GAC/B,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,GACjB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOxE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,GACjB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOxE;AAqCD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE,CAU/G;AAED,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,EAC5C,YAAY,EAAE,MAAM,GAAG,UAAU,GAClC,cAAc,EAAE,CAsBlB;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,GAAG,aAAa,EAAE,CAwB/G"}

package/lib/prompts/render.js

@@ -1,31 +1,28 @@
 import { PromptSegmentDefType, TemplateType } from '@vertesia/common';
-import { CompositeError, renderHandlebarsTemplate, renderJsTemplate } from '@vertesia/jst';
+import { CompositeError, renderHandlebarsTemplate, renderJsTemplate, withTemplateSystemVariables, } from '@vertesia/jst';
 /**
  * Render a prompt template with the given input data.
  *
- * Handlebars templates use {{variable}} interpolation against `data`.
- * JST (JavaScript template) bodies evaluate against `data` with the schema's top-level
- * property names exposed as globals, plus `_model` — the active model id, which the
- * studio-server executor injects into the input as `{ ..._model: run.modelId }` when
- * executing an interaction (see `apps/studio-server/src/executor/ExecutionRequest.ts`
- * and `apps/studio-server/src/executor/rendering/template.ts`). Listing it here keeps
- * the Playground preview and `validatePrompt` in sync with runtime resolution — a JST
- * template referencing `_model` validates fine here and renders fine in production.
+ * Handlebars templates use {{variable}} interpolation against `data`. JST (JavaScript template)
+ * bodies evaluate against `data` with the schema's top-level property names exposed as globals.
+ * Both see the system variables (`TEMPLATE_SYSTEM_VARIABLES` in `@vertesia/jst`), added here the
+ * same way the studio-server executor adds them, so a preview renders what an execution would.
+ * `_model` is only set when the caller passes `system.model` or the data already carries it.
  *
  * For `TemplateType.text`, the content is returned verbatim — it is static text, not a
  * template — matching the studio-server executor (see `apps/studio-server/src/executor/
  * rendering/template.ts`). Routing it through the JST evaluator would compile the prose as
  * JavaScript and throw on any plain sentence (e.g. "You are a helpful assistant.").
  */
-export function renderTemplate(code, contentType, schema, data) {
-    if (contentType === TemplateType.handlebars) {
-        return renderHandlebarsTemplate(code, data);
-    }
+export function renderTemplate(code, contentType, schema, data, system) {
     if (contentType === TemplateType.text) {
         return code;
     }
-    const globals = [...(schema.properties ? Object.keys(schema.properties) : []), '_model'];
-    return renderJsTemplate(code, globals, data);
+    const input = withTemplateSystemVariables(data, system);
+    if (contentType === TemplateType.handlebars) {
+        return renderHandlebarsTemplate(code, input);
+    }
+    return renderJsTemplate(code, schema.properties ? Object.keys(schema.properties) : [], input);
 }
 /**
  * Execute a JST (JavaScript Template) with given data.

package/lib/prompts/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/prompts/render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/prompts/render.ts"],"names":[],"mappings":"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"}

package/lib/prompts/validate.d.ts

@@ -1,5 +1,5 @@
 import { type JSONSchema, TemplateType } from '@vertesia/common';
-export type PromptValidationIssueType = 'undeclared_template_variable' | 'unused_schema_variable' | 'handlebars_render_error' | 'jst_unsafe_construct' | 'jst_render_error';
+export type PromptValidationIssueType = 'undeclared_template_variable' | 'unused_schema_variable' | 'reserved_variable_declared' | 'system_variable_property_access' | 'helper_used_as_value' | 'helper_missing_arguments' | 'handlebars_render_error' | 'jst_unsafe_construct' | 'jst_render_error';
 export type PromptValidationIssueSeverity = 'error' | 'warning';
 export interface PromptValidationIssue {
     /** Discriminator for issue kind */
@@ -32,9 +32,15 @@ export interface PromptValidationInput {
  *
  * For `handlebars` and `jst` templates, the following checks are performed:
  *  1. Every variable referenced in the template must be declared as a top-level property
- *     in `inputSchema.properties` (else → `undeclared_template_variable` error).
+ *     in `inputSchema.properties` (else → `undeclared_template_variable` error). System variables
+ *     (`TEMPLATE_SYSTEM_VARIABLES` in `@vertesia/jst`) are supplied at runtime and need no declaration;
+ *     declaring one → `reserved_variable_declared` warning, reading a property of one →
+ *     `system_variable_property_access` error.
  *  2. Every property declared in `inputSchema.properties` should be referenced by the template
  *     (else → `unused_schema_variable` warning — non-blocking).
+ *  For Handlebars only: a helper passed as an argument (`{{#if stringify}}`) →
+ *     `helper_used_as_value` error; a helper called bare without the arguments it needs
+ *     (`{{stringify}}`) → `helper_missing_arguments` error.
  *  3. The template must render successfully against schema-derived mock data
  *     (else → `handlebars_render_error` / `jst_render_error` error).
  *  4. For JST only: unsafe constructs (`with`, `for`, `while`, `import`, class, `this`,

package/lib/prompts/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/prompts/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMjE,MAAM,MAAM,yBAAyB,GAC/B,8BAA8B,GAC9B,wBAAwB,GACxB,yBAAyB,GACzB,sBAAsB,GACtB,kBAAkB,CAAC;AAEzB,MAAM,MAAM,6BAA6B,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IAClC,mCAAmC;IACnC,IAAI,EAAE,yBAAyB,CAAC;IAChC,uEAAuE;IACvE,QAAQ,EAAE,6BAA6B,CAAC;IACxC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACnC,2FAA2F;IAC3F,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IAClC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,WAAW,EAAE,YAAY,CAAC;IAC1B,gEAAgE;IAChE,WAAW,CAAC,EAAE,UAAU,CAAC;CAC5B;AAkJD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAWnF"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/prompts/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAcjE,MAAM,MAAM,yBAAyB,GAC/B,8BAA8B,GAC9B,wBAAwB,GACxB,4BAA4B,GAC5B,iCAAiC,GACjC,sBAAsB,GACtB,0BAA0B,GAC1B,yBAAyB,GACzB,sBAAsB,GACtB,kBAAkB,CAAC;AAEzB,MAAM,MAAM,6BAA6B,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IAClC,mCAAmC;IACnC,IAAI,EAAE,yBAAyB,CAAC;IAChC,uEAAuE;IACvE,QAAQ,EAAE,6BAA6B,CAAC;IACxC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACnC,2FAA2F;IAC3F,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IAClC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,WAAW,EAAE,YAAY,CAAC;IAC1B,gEAAgE;IAChE,WAAW,CAAC,EAAE,UAAU,CAAC;CAC5B;AAyLD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAWnF"}

package/lib/prompts/validate.js

@@ -1,17 +1,8 @@
 import { TemplateType } from '@vertesia/common';
-import { getFreeVariables, renderJsTemplate } from '@vertesia/jst';
-import { extractHandlebarsVariables } from './extract-vars.js';
+import { describeTemplateSystemVariables, getFreeVariables, isTemplateSystemVariable, JST_TEMPLATE_GLOBALS, renderJsTemplate, TEMPLATE_SYSTEM_VARIABLES, withTemplateSystemVariables, } from '@vertesia/jst';
+import { analyzeHandlebarsTemplate } from './extract-vars.js';
 import { generateMockData } from './mock-data.js';
 import { executeHandlebars } from './render.js';
-// JST's renderJsTemplate auto-adds `_` (helpers object) and runtime injects `Set` and `Array`
-// — treat them as globals so they don't appear as free vars in user templates.
-// Globals always available to JST templates regardless of schema:
-//  - `_`, `Array`, `Set`: runtime-injected by `renderJsTemplate` (jst library)
-//  - `_model`: runtime-injected by the studio-server executor as `{ ..._model: run.modelId }`
-//    (see ExecutionRequest.ts:313 and executor/rendering/template.ts:13)
-// Keeping these in sync with `renderTemplate` in ./render.ts so a JST template that runs in
-// production also passes the validator.
-const JST_AUTO_GLOBALS = ['_', 'Array', 'Set', '_model'];
 function countSeverities(issues) {
     let error_count = 0;
     let warning_count = 0;
@@ -25,38 +16,96 @@ function countSeverities(issues) {
     }
     return { error_count, warning_count };
 }
-function validateHandlebarsPrompt(content, inputSchema) {
+/** Mock data for the render smoke test: schema-shaped input plus the runtime system values. */
+function buildMockInput(inputSchema) {
+    const mockData = generateMockData(inputSchema);
+    const mockObject = typeof mockData === 'object' && mockData !== null && !Array.isArray(mockData) ? mockData : {};
+    return withTemplateSystemVariables(mockObject, { model: 'validation-model' });
+}
+/**
+ * Issues shared by both template languages: reserved names declared in the schema, and
+ * unused schema properties. `usedVars` holds the input variables the template reads.
+ */
+function checkDeclarations(declaredVars, usedVars, usageHint) {
     const issues = [];
-    const usedVars = extractHandlebarsVariables(content);
-    const declaredVars = new Set(inputSchema?.properties ? Object.keys(inputSchema.properties) : []);
-    for (const used of usedVars) {
-        if (!declaredVars.has(used)) {
+    for (const declared of declaredVars) {
+        if (isTemplateSystemVariable(declared)) {
             issues.push({
-                type: 'undeclared_template_variable',
-                severity: 'error',
-                variable: used,
-                message: `Template references variable '{{${used}}}' but it is not declared in input_schema.properties. Add '${used}' to the schema with an appropriate type.`,
+                type: 'reserved_variable_declared',
+                severity: 'warning',
+                variable: declared,
+                message: `Schema declares '${declared}', a system variable the runtime supplies and overrides. Remove it from input_schema.`,
             });
         }
-    }
-    for (const declared of declaredVars) {
-        if (!usedVars.has(declared)) {
+        else if (!usedVars.has(declared)) {
             issues.push({
                 type: 'unused_schema_variable',
                 severity: 'warning',
                 variable: declared,
-                message: `Schema declares property '${declared}' but the template never references it. Remove it from input_schema or use it via {{${declared}}}.`,
+                message: `Schema declares property '${declared}' but the template never references it. Remove it from input_schema or ${usageHint(declared)}.`,
             });
         }
     }
+    return issues;
+}
+function undeclaredVariableIssue(name, where) {
+    return {
+        type: 'undeclared_template_variable',
+        severity: 'error',
+        variable: name,
+        message: `Template reads variable '${name}' ${where} but it is not declared in input_schema.properties. ` +
+            `Add '${name}' to the schema with an appropriate type. ` +
+            `System variables need no declaration: ${describeTemplateSystemVariables()}.`,
+    };
+}
+function validateHandlebarsPrompt(content, inputSchema) {
+    const issues = [];
+    const analysis = analyzeHandlebarsTemplate(content);
+    const declaredVars = new Set(inputSchema?.properties ? Object.keys(inputSchema.properties) : []);
+    const usedVars = new Set();
+    const reported = new Set();
+    for (const ref of analysis?.references ?? []) {
+        if (isTemplateSystemVariable(ref.name)) {
+            const variable = TEMPLATE_SYSTEM_VARIABLES.find((v) => v.name === ref.name);
+            if (ref.hasPath && variable?.type === 'string' && !reported.has(`path:${ref.expression}`)) {
+                reported.add(`path:${ref.expression}`);
+                issues.push({
+                    type: 'system_variable_property_access',
+                    severity: 'error',
+                    variable: ref.name,
+                    message: `'${ref.expression}' in ${ref.tag} reads a property of system variable '${ref.name}', which is a string (${variable.description}). Use '${ref.name}' directly.`,
+                });
+            }
+            continue;
+        }
+        usedVars.add(ref.name);
+        if (!declaredVars.has(ref.name) && !reported.has(ref.name)) {
+            reported.add(ref.name);
+            issues.push(undeclaredVariableIssue(ref.name, `in ${ref.tag}`));
+        }
+    }
+    for (const misuse of analysis?.helperMisuses ?? []) {
+        issues.push(misuse.problem === 'used_as_value'
+            ? {
+                type: 'helper_used_as_value',
+                severity: 'error',
+                variable: misuse.helper,
+                message: `'${misuse.helper}' in ${misuse.tag} is a helper, but as an argument Handlebars reads it as data, which is empty. Call it as a subexpression: (${misuse.helper} ...).`,
+            }
+            : {
+                type: 'helper_missing_arguments',
+                severity: 'error',
+                variable: misuse.helper,
+                message: `${misuse.tag} calls helper '${misuse.helper}' without arguments. Pass the value it operates on, e.g. {{${misuse.helper} value}}.`,
+            });
+    }
+    issues.push(...checkDeclarations(declaredVars, usedVars, (name) => `use it via {{${name}}}`));
     // Render-time smoke test — always runs so syntax errors and failing helper calls are
     // surfaced even when undeclared-variable errors are already in the list. Handlebars renders
     // missing vars as empty strings (non-strict by default), so the render check does NOT echo
     // the var errors — anything it reports is a distinct template problem worth showing.
     const renderSchema = inputSchema ?? {};
-    const mockData = generateMockData(renderSchema);
-    const mockObject = typeof mockData === 'object' && mockData !== null && !Array.isArray(mockData) ? mockData : {};
-    const renderResult = executeHandlebars(content, renderSchema, mockObject);
+    const renderResult = executeHandlebars(content, renderSchema, buildMockInput(renderSchema));
     if (!renderResult.success) {
         issues.push({
             type: 'handlebars_render_error',
@@ -72,7 +121,7 @@ function validateJstPrompt(content, inputSchema) {
     let referenced;
     try {
         const result = getFreeVariables(content, {
-            globals: JST_AUTO_GLOBALS,
+            globals: [...JST_TEMPLATE_GLOBALS],
             acorn: { allowReturnOutsideFunction: true, locations: true },
         });
         referenced = result.vars;
@@ -95,35 +144,17 @@ function validateJstPrompt(content, inputSchema) {
     }
     for (const used of referenced) {
         if (!declaredVars.has(used)) {
-            issues.push({
-                type: 'undeclared_template_variable',
-                severity: 'error',
-                variable: used,
-                message: `Template references variable '${used}' but it is not declared in input_schema.properties. Add '${used}' to the schema with an appropriate type.`,
-            });
-        }
-    }
-    for (const declared of declaredVars) {
-        if (!referenced.has(declared)) {
-            issues.push({
-                type: 'unused_schema_variable',
-                severity: 'warning',
-                variable: declared,
-                message: `Schema declares property '${declared}' but the template never references it. Remove it from input_schema or use it in the template.`,
-            });
+            issues.push(undeclaredVariableIssue(used, 'in the template'));
         }
     }
+    issues.push(...checkDeclarations(declaredVars, referenced, () => 'use it in the template'));
     // Render-time smoke test — only if there are no blocking errors so far, otherwise
     // the failure mode would just echo what we already reported.
     const blockingSoFar = issues.some((i) => i.severity === 'error');
     if (!blockingSoFar) {
         const renderSchema = inputSchema ?? {};
-        const mockData = generateMockData(renderSchema);
-        const mockObject = typeof mockData === 'object' && mockData !== null && !Array.isArray(mockData)
-            ? mockData
-            : {};
         try {
-            renderJsTemplate(content, [...declaredVars], mockObject);
+            renderJsTemplate(content, [...declaredVars], buildMockInput(renderSchema));
         }
         catch (renderError) {
             issues.push({
@@ -140,9 +171,15 @@ function validateJstPrompt(content, inputSchema) {
  *
  * For `handlebars` and `jst` templates, the following checks are performed:
  *  1. Every variable referenced in the template must be declared as a top-level property
- *     in `inputSchema.properties` (else → `undeclared_template_variable` error).
+ *     in `inputSchema.properties` (else → `undeclared_template_variable` error). System variables
+ *     (`TEMPLATE_SYSTEM_VARIABLES` in `@vertesia/jst`) are supplied at runtime and need no declaration;
+ *     declaring one → `reserved_variable_declared` warning, reading a property of one →
+ *     `system_variable_property_access` error.
  *  2. Every property declared in `inputSchema.properties` should be referenced by the template
  *     (else → `unused_schema_variable` warning — non-blocking).
+ *  For Handlebars only: a helper passed as an argument (`{{#if stringify}}`) →
+ *     `helper_used_as_value` error; a helper called bare without the arguments it needs
+ *     (`{{stringify}}`) → `helper_missing_arguments` error.
  *  3. The template must render successfully against schema-derived mock data
  *     (else → `handlebars_render_error` / `jst_render_error` error).
  *  4. For JST only: unsafe constructs (`with`, `for`, `while`, `import`, class, `this`,

package/lib/prompts/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/prompts/validate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/prompts/validate.ts"],"names":[],"mappings":"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"}

package/lib/roles/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/roles/system.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,aAAa,EAAc,MAAM,cAAc,CAAC;AAuMzE,eAAO,MAAM,eAAe,EAAE,aAG7B,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/roles/system.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,aAAa,EAAc,MAAM,cAAc,CAAC;AAuNzE,eAAO,MAAM,eAAe,EAAE,aAG7B,CAAC"}

package/lib/roles/system.js

@@ -15,6 +15,20 @@ class AdminRole extends OrgMemberRole {
         super(SystemRoles.admin, Object.values(Permission));
     }
 }
+/**
+ * Full `admin` rights minus Studio UI access. For an account administrator who operates the
+ * platform through a custom admin UI and must not reach Vertesia Studio itself.
+ *
+ * Keep in lockstep with `AdminRole`: `studio_access` is the only intended difference, so a new
+ * permission added to the central enum reaches both roles automatically.
+ */
+class AppAdminRole extends AdminRole {
+    constructor() {
+        super();
+        this.name = SystemRoles.app_admin;
+        this.permissions.delete(Permission.studio_access);
+    }
+}
 class ManagerRole extends OrgMemberRole {
     constructor() {
         super(SystemRoles.manager, Object.values(Permission));
@@ -165,6 +179,7 @@ class ContentSuperAdmin extends DeveloperRole {
 const systemRoles = {
     [SystemRoles.owner]: new OwnerRole(),
     [SystemRoles.admin]: new AdminRole(),
+    [SystemRoles.app_admin]: new AppAdminRole(),
     [SystemRoles.manager]: new ManagerRole(),
     [SystemRoles.developer]: new DeveloperRole(),
     [SystemRoles.application]: new ApplicationRole(),

package/lib/roles/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/roles/system.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/roles/system.ts"],"names":[],"mappings":"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"}

package/lib/vertesia-studio-utils.js

@@ -1,2 +1,3 @@
-import e from"handlebars";import{Permission as t,PromptSegmentDefType as n,SystemRoles as r,TemplateType as i}from"@vertesia/common";import{CompositeError as a,getFreeVariables as o,renderHandlebarsTemplate as s,renderJsTemplate as c}from"@vertesia/jst";function l(e,t){return!e||!t?e:e.replace(/\{\{\s*(\w+)\s*\}\}/g,(e,n)=>{let r=t[n];return typeof r!=`string`||!r?e:u(r)})}function u(e){let t=e.length;for(;t>0&&e[t-1]===`/`;)t--;return t===e.length?e:e.slice(0,t)}function d(t){let n;try{n=e.parse(t)}catch{return new Set}let r=new Set,i=[],a=e=>i.some(t=>t.has(e)),o=e=>{if(!e||typeof e!=`object`)return;let t=e;switch(t.type){case`Program`:{let e=t.body;if(e)for(let t of e)o(t);break}case`BlockStatement`:{let e=t.params;if(e)for(let t of e)o(t);o(t.hash);let n=t.program,r=t.inverse,a=new Set([...n?.blockParams??[],...r?.blockParams??[]]);i.push(a),o(t.program),o(t.inverse),i.pop();break}case`MustacheStatement`:{let e=t.params,n=t.hash;if((e?.length??0)>0||(n?.pairs?.length??0)>0||o(t.path),e)for(let t of e)o(t);o(n);break}case`SubExpression`:{let e=t.params;if(e)for(let t of e)o(t);o(t.hash);break}case`PathExpression`:{if(t.data)break;let e=t.parts;if(!e||e.length===0)break;let n=e[0];if(a(n))break;r.add(n);break}case`Hash`:{let e=t.pairs;if(e)for(let t of e)o(t.value);break}}};return o(n),r}function f(e,t=`value`){if(`$ref`in e)return`%${t}%`;switch((Array.isArray(e.type)?e.type:[e.type])[0]){case`string`:return`%${t}%`;case`number`:case`integer`:return Math.floor(Math.random()*101);case`boolean`:return!0;case`array`:{let n=e.items;if(n){let e=Math.floor(Math.random()*2)+1;return Array.from({length:e},(e,r)=>f(n,`${t}_${r}`))}return[]}case`object`:{let t={};if(e.properties)for(let[n,r]of Object.entries(e.properties))t[n]=f(r,n);return t}case`null`:return null;default:return`%${t}%`}}function p(e,t,n,r){if(t===i.handlebars)return s(e,r);if(t===i.text)return e;let a=[...n.properties?Object.keys(n.properties):[],`_model`];return c(e,a,r)}function m(e,t,n){try{return{success:!0,content:p(e,i.jst,t,n)}}catch(e){return{success:!1,error:e instanceof Error?e.message:String(e)}}}function h(e,t,n){try{return{success:!0,content:p(e,i.handlebars,t,n)}}catch(e){return{success:!1,error:e instanceof Error?e.message:String(e)}}}function g(e,t){let n=x(e.configuration),r=t[n],i;return i=Array.isArray(r)?JSON.stringify(r,void 0,2):`No "${n}" property found on input data`,{title:`Chat history`,content:i}}function _(e,t){if(!e.template)return{title:`(unknown segment)`,content:``,error:Error(`Prompt segment is missing its template`)};let n=e.template.inputSchema||{},r=`@${e.template.role}`;try{return{title:r,content:p(e.template.content,e.template.content_type,n,t),segmentId:e.template.id}}catch(t){return{title:r,content:t instanceof Error?t.message:String(t),segmentId:e.template.id,error:t instanceof Error?t:Error(String(t))}}}function v(e,t){let r=[];for(let i of e)i.type===n.chat?r.push(g(i,t)):i.type===n.template&&r.push(_(i,t));return r}function y(e,t){try{return v(e,typeof t==`string`?JSON.parse(t.trim()):t||{})}catch(e){return e instanceof a?e.errors.map(e=>({error:e,title:`Rendering Error`,content:e.message})):[{error:e instanceof Error?e:Error(String(e)),title:`Rendering Error`,content:e instanceof Error?e.message:String(e)}]}}function b(e,t){let r=[];for(let i of e)if(i.template){let e=i.template.inputSchema||{},n=p(i.template.content,i.template.content_type,e,t);r.push({role:i.template.role,content:n})}else if(i.type===n.chat){let e=t[x(i.configuration)];if(!ee(e))throw Error(`Chat prompt segment must have a messages array`);for(let t of e){if(!t.role)throw Error(`Chat prompt segment must have a role`);r.push({role:t.role,content:t.content})}}else throw Error(`Unknown prompt segment type: ${i.type}`);return r}function x(e){return typeof e==`object`&&e&&`chatKey`in e&&typeof e.chatKey==`string`?e.chatKey:`chat`}function ee(e){return Array.isArray(e)&&e.every(S)}function S(e){return typeof e==`object`&&!!e&&`role`in e&&`content`in e}const te=[`_`,`Array`,`Set`,`_model`];function ne(e){let t=0,n=0;for(let r of e)r.severity===`error`?t++:r.severity===`warning`&&n++;return{error_count:t,warning_count:n}}function re(e,t){let n=[],r=d(e),i=new Set(t?.properties?Object.keys(t.properties):[]);for(let e of r)i.has(e)||n.push({type:`undeclared_template_variable`,severity:`error`,variable:e,message:`Template references variable '{{${e}}}' but it is not declared in input_schema.properties. Add '${e}' to the schema with an appropriate type.`});for(let e of i)r.has(e)||n.push({type:`unused_schema_variable`,severity:`warning`,variable:e,message:`Schema declares property '${e}' but the template never references it. Remove it from input_schema or use it via {{${e}}}.`});let a=t??{},o=f(a),s=h(e,a,typeof o==`object`&&o&&!Array.isArray(o)?o:{});return s.success||n.push({type:`handlebars_render_error`,severity:`error`,message:`Handlebars rendering failed: ${s.error}`}),n}function ie(e,t){let n=[],r=new Set(t?.properties?Object.keys(t.properties):[]),i;try{let t=o(e,{globals:te,acorn:{allowReturnOutsideFunction:!0,locations:!0}});i=t.vars;for(let e of t.errors)n.push({type:`jst_unsafe_construct`,severity:`error`,message:`JST validation error at ${e.location}: ${e.message}`})}catch(e){return n.push({type:`jst_render_error`,severity:`error`,message:`JST parse failed: ${e instanceof Error?e.message:String(e)}`}),n}for(let e of i)r.has(e)||n.push({type:`undeclared_template_variable`,severity:`error`,variable:e,message:`Template references variable '${e}' but it is not declared in input_schema.properties. Add '${e}' to the schema with an appropriate type.`});for(let e of r)i.has(e)||n.push({type:`unused_schema_variable`,severity:`warning`,variable:e,message:`Schema declares property '${e}' but the template never references it. Remove it from input_schema or use it in the template.`});if(!n.some(e=>e.severity===`error`)){let i=f(t??{}),a=typeof i==`object`&&i&&!Array.isArray(i)?i:{};try{c(e,[...r],a)}catch(e){n.push({type:`jst_render_error`,severity:`error`,message:`JST rendering failed: ${e instanceof Error?e.message:String(e)}`})}}return n}function C(e){let t;t=e.contentType===i.handlebars?re(e.content,e.inputSchema):e.contentType===i.jst?ie(e.content,e.inputSchema):[];let{error_count:n,warning_count:r}=ne(t);return{issues:t,error_count:n,warning_count:r}}var w=class{name;domain;permissions;constructor(e,t,n){this.name=e,this.domain=n,this.permissions=new Set(t)}hasPermission(e){return this.permissions.has(e)}},T=class extends w{constructor(e,t){super(e,t,`system`)}},E=class extends w{applicableScopes;constructor(e,t,n,r){super(e,t,n),this.applicableScopes=r}};const D=`content`,O=[`document`,`collection`];var k;(function(e){e.content_reader=`content:reader`,e.content_writer=`content:writer`,e.content_manager=`content:manager`})(k||={});var A=class extends E{constructor(){super(k.content_reader,[`read`],D,O)}},j=class extends E{constructor(){super(k.content_writer,[`read`,`write`],D,O)}},M=class extends E{constructor(){super(k.content_manager,[`read`,`write`,`delete`],D,O)}};const N={[k.content_reader]:new A,[k.content_writer]:new j,[k.content_manager]:new M},P={domain:D,roles:new Map(Object.entries(N))};var F=class extends T{constructor(e,n){super(e,[t.account_member,...n])}},I=class extends F{constructor(){super(r.owner,Object.values(t))}},L=class extends F{constructor(){super(r.admin,Object.values(t))}},R=class extends F{constructor(){super(r.manager,Object.values(t)),this.permissions.delete(t.account_admin),this.permissions.delete(t.manage_billing),this.permissions.delete(t.audit_read),this.permissions.delete(t.agent_run_read),this.permissions.delete(t.content_read_all),this.permissions.delete(t.content_superadmin),this.permissions.delete(t.workflow_superadmin)}},z=class extends F{constructor(){super(r.developer,Object.values(t)),this.permissions.delete(t.account_admin),this.permissions.delete(t.project_admin),this.permissions.delete(t.project_settings_write),this.permissions.delete(t.env_admin),this.permissions.delete(t.manage_billing),this.permissions.delete(t.audit_read),this.permissions.delete(t.agent_run_read),this.permissions.delete(t.content_read_all),this.permissions.delete(t.content_superadmin),this.permissions.delete(t.workflow_superadmin)}},B=class extends F{constructor(){super(r.application,[t.int_read,t.int_execute,t.int_write,t.run_read,t.content_write,t.content_read,t.content_write,t.content_admin,t.project_admin,t.workflow_run,t.project_settings_write,t.account_write])}},V=class extends F{constructor(){super(r.automation,[t.content_read,t.content_write,t.content_admin,t.int_read,t.int_execute,t.run_read,t.workflow_run,t.project_integration_read])}},H=class extends F{constructor(){super(r.content_processor,[t.content_read,t.content_write,t.content_admin,t.content_superadmin,t.int_execute,t.workflow_read,t.workflow_run,t.run_read])}},U=class extends F{constructor(){super(r.consumer,[t.content_admin,t.content_read,t.content_write,t.content_delete,t.int_read,t.int_execute,t.run_read,t.workflow_run])}},W=class extends F{constructor(){super(r.executor,[t.int_execute,t.run_read,t.workflow_run])}},G=class extends F{constructor(){super(r.reader,[t.int_read,t.run_read,t.content_read])}};const K=[t.studio_access,t.account_read,t.project_integration_read,t.api_key_read,t.billing_read,t.audit_read,t.int_read,t.run_read,t.content_read,t.content_read_all,t.task_read,t.workflow_read,t.agent_run_read];var q=class extends F{constructor(e){super(e,K)}},J=class extends F{constructor(){super(r.billing,[t.manage_billing])}},Y=class extends F{constructor(){super(r.app_member,[t.int_read,t.int_execute,t.int_write,t.run_read,t.content_write,t.content_read,t.content_delete,t.workflow_run])}},ae=class extends z{constructor(){super(),this.name=r.content_superadmin,this.permissions.add(t.content_superadmin)}};const oe={[r.owner]:new I,[r.admin]:new L,[r.manager]:new R,[r.developer]:new z,[r.application]:new B,[r.automation]:new V,[r.content_processor]:new H,[r.consumer]:new U,[r.executor]:new W,[r.reader]:new G,[r.auditor]:new q(r.auditor),[r.support]:new q(r.support),[r.billing]:new J,[r.app_member]:new Y,[r.member]:new F(r.member,[]),[r.content_superadmin]:new ae},X=[{domain:`system`,roles:new Map(Object.entries(oe))},P];function Z(e){for(let t of X){let n=t.roles.get(e);if(n)return n}throw Error(`Role ${e} not found`)}function Q(){let e=[];for(let t of X)for(let n of t.roles.values())e.push(n);return e}function $(e){let t=X.find(t=>t.domain===e);return t?Array.from(t.roles.values()):[]}function se(e){return Q().filter(t=>t instanceof E&&t.applicableScopes.includes(e))}function ce(){return Q().filter(e=>e instanceof T)}function le(){return Q().map(e=>e.name)}function ue(e){let t=new Set;for(let n of e){let e=Z(n);for(let n of e.permissions)t.add(n)}return Array.from(t)}function de(e){let t=Z(e);return t instanceof E?[...t.permissions].map(e=>`${t.domain}:${e}`):[...t.permissions]}var fe=class e{roles;constructor(e){this.roles=e}static fromRoleNames(t){let n=t.map(e=>Z(e));return new e(n)}static fromRoleName(t){let n=[Z(t)];return new e(n)}hasPermission(e){return this.roles.some(t=>t.hasPermission(e))}};export{E as AbacRole,k as ContentRoleNames,w as Role,fe as RoleList,T as SystemRole,h as executeHandlebars,m as executeJST,d as extractHandlebarsVariables,f as generateMockData,le as getAllRoleNames,de as getDelegablePermissionsForRole,ue as getPermissionsForRoles,Z as getRoleByName,se as listAbacRolesForScope,Q as listRoles,$ as listRolesByDomain,ce as listSystemRoles,b as renderPrompt,v as renderSegments,y as renderSegmentsOrErrors,p as renderTemplate,l as substituteEndpoints,C as validatePrompt};
+import{CompositeError as e,HANDLEBARS_CONTEXT_HELPERS as t,HANDLEBARS_HELPER_NAMES as n,JST_TEMPLATE_GLOBALS as r,TEMPLATE_SYSTEM_VARIABLES as i,TEMPLATE_SYSTEM_VARIABLES as a,TEMPLATE_SYSTEM_VARIABLE_NAMES as o,describeTemplateSystemVariables as s,describeTemplateSystemVariables as c,getFreeVariables as l,isHandlebarsHelper as u,isTemplateSystemVariable as d,isTemplateSystemVariable as f,renderHandlebarsTemplate as p,renderJsTemplate as m,withTemplateSystemVariables as h,withTemplateSystemVariables as g}from"@vertesia/jst";import _ from"handlebars";import{Permission as v,PromptSegmentDefType as y,SystemRoles as b,TemplateType as x}from"@vertesia/common";function ee(e,t){return!e||!t?e:e.replace(/\{\{\s*(\w+)\s*\}\}/g,(e,n)=>{let r=t[n];return typeof r!=`string`||!r?e:S(r)})}function S(e){let t=e.length;for(;t>0&&e[t-1]===`/`;)t--;return t===e.length?e:e.slice(0,t)}function C(e){return!!e&&typeof e==`object`&&e.type===`PathExpression`}function w(e){return/^\.|this\b/.test(e.original)}function T(e){return e.parts.length===1&&!w(e)&&!e.data&&e.depth===0}function E(e){let t=[0];for(let n=0;n<e.length;n++)e[n]===`
+`&&t.push(n+1);return t}function D(e){let n;try{n=_.parse(e)}catch{return null}let r=E(e),i=t=>{if(!t)return``;let n=(r[t.start.line-1]??0)+t.start.column,i=e.indexOf(`}}`,n);return i<0?e.slice(n):e.slice(n,e[i+2]===`}`?i+3:i+2)},a=[],o=[],s=[`root`],c=[],l=``,d=e=>c.some(t=>t.has(e)),p=e=>{if(e.data){e.parts[0]===`root`&&e.parts.length>1&&a.push({name:e.parts[1],expression:e.original,hasPath:e.parts.length>2,tag:l});return}if(e.parts.length===0)return;let t=e.parts[0];e.depth===0&&!w(e)&&d(t)||s[Math.max(0,s.length-1-e.depth)]===`root`&&a.push({name:t,expression:e.original,hasPath:e.parts.length>1,tag:l})},m=e=>{if(C(e)){let t=e.parts[0];if(T(e)&&!d(t)&&u(t)&&!f(t)){o.push({helper:t,problem:`used_as_value`,tag:l});return}p(e);return}v(e)},h=e=>{let t=e.params??[];for(let e of t)m(e);let n=e.hash?.pairs??[];for(let e of n)m(e.value)},g=e=>(e.params?.length??0)>0||(e.hash?.pairs?.length??0)>0,v=e=>{if(!e||typeof e!=`object`)return;let n=e;switch(n.type){case`Program`:for(let e of n.body??[])v(e);break;case`MustacheStatement`:{l=i(n.loc);let e=n.path;if(g(n))h(n);else if(C(e)){let t=e.parts[0];T(e)&&!d(t)&&u(t)?f(t)||o.push({helper:t,problem:`missing_arguments`,tag:l}):p(e)}else v(e);break}case`BlockStatement`:{l=i(n.loc);let e=n.path,r=C(e)&&T(e)?e.parts[0]:void 0,a;g(n)||r&&u(r)?(h(n),a=!!r&&t.includes(r)):(C(e)&&p(e),a=!0);let o=n.program,d=n.inverse;c.push(new Set(o?.blockParams??[])),s.push(a?`item`:s[s.length-1]),v(n.program),s.pop(),c.pop(),c.push(new Set(d?.blockParams??[])),v(n.inverse),c.pop();break}case`SubExpression`:h(n)}};return v(n),{references:a,helperMisuses:o}}function O(e){let t=D(e);return new Set(t?.references.map(e=>e.name)??[])}function k(e,t=`value`){if(`$ref`in e)return`%${t}%`;switch((Array.isArray(e.type)?e.type:[e.type])[0]){case`string`:return`%${t}%`;case`number`:case`integer`:return Math.floor(Math.random()*101);case`boolean`:return!0;case`array`:{let n=e.items;if(n){let e=Math.floor(Math.random()*2)+1;return Array.from({length:e},(e,r)=>k(n,`${t}_${r}`))}return[]}case`object`:{let t={};if(e.properties)for(let[n,r]of Object.entries(e.properties))t[n]=k(r,n);return t}case`null`:return null;default:return`%${t}%`}}function A(e,t,n,r,i){if(t===x.text)return e;let a=g(r,i);return t===x.handlebars?p(e,a):m(e,n.properties?Object.keys(n.properties):[],a)}function j(e,t,n){try{return{success:!0,content:A(e,x.jst,t,n)}}catch(e){return{success:!1,error:e instanceof Error?e.message:String(e)}}}function M(e,t,n){try{return{success:!0,content:A(e,x.handlebars,t,n)}}catch(e){return{success:!1,error:e instanceof Error?e.message:String(e)}}}function te(e,t){let n=P(e.configuration),r=t[n],i;return i=Array.isArray(r)?JSON.stringify(r,void 0,2):`No "${n}" property found on input data`,{title:`Chat history`,content:i}}function ne(e,t){if(!e.template)return{title:`(unknown segment)`,content:``,error:Error(`Prompt segment is missing its template`)};let n=e.template.inputSchema||{},r=`@${e.template.role}`;try{return{title:r,content:A(e.template.content,e.template.content_type,n,t),segmentId:e.template.id}}catch(t){return{title:r,content:t instanceof Error?t.message:String(t),segmentId:e.template.id,error:t instanceof Error?t:Error(String(t))}}}function N(e,t){let n=[];for(let r of e)r.type===y.chat?n.push(te(r,t)):r.type===y.template&&n.push(ne(r,t));return n}function re(t,n){try{return N(t,typeof n==`string`?JSON.parse(n.trim()):n||{})}catch(t){return t instanceof e?t.errors.map(e=>({error:e,title:`Rendering Error`,content:e.message})):[{error:t instanceof Error?t:Error(String(t)),title:`Rendering Error`,content:t instanceof Error?t.message:String(t)}]}}function ie(e,t){let n=[];for(let r of e)if(r.template){let e=r.template.inputSchema||{},i=A(r.template.content,r.template.content_type,e,t);n.push({role:r.template.role,content:i})}else if(r.type===y.chat){let e=t[P(r.configuration)];if(!ae(e))throw Error(`Chat prompt segment must have a messages array`);for(let t of e){if(!t.role)throw Error(`Chat prompt segment must have a role`);n.push({role:t.role,content:t.content})}}else throw Error(`Unknown prompt segment type: ${r.type}`);return n}function P(e){return typeof e==`object`&&e&&`chatKey`in e&&typeof e.chatKey==`string`?e.chatKey:`chat`}function ae(e){return Array.isArray(e)&&e.every(oe)}function oe(e){return typeof e==`object`&&!!e&&`role`in e&&`content`in e}function F(e){let t=0,n=0;for(let r of e)r.severity===`error`?t++:r.severity===`warning`&&n++;return{error_count:t,warning_count:n}}function I(e){let t=k(e);return g(typeof t==`object`&&t&&!Array.isArray(t)?t:{},{model:`validation-model`})}function L(e,t,n){let r=[];for(let i of e)f(i)?r.push({type:`reserved_variable_declared`,severity:`warning`,variable:i,message:`Schema declares '${i}', a system variable the runtime supplies and overrides. Remove it from input_schema.`}):t.has(i)||r.push({type:`unused_schema_variable`,severity:`warning`,variable:i,message:`Schema declares property '${i}' but the template never references it. Remove it from input_schema or ${n(i)}.`});return r}function R(e,t){return{type:`undeclared_template_variable`,severity:`error`,variable:e,message:`Template reads variable '${e}' ${t} but it is not declared in input_schema.properties. Add '${e}' to the schema with an appropriate type. System variables need no declaration: ${c()}.`}}function se(e,t){let n=[],r=D(e),i=new Set(t?.properties?Object.keys(t.properties):[]),o=new Set,s=new Set;for(let e of r?.references??[]){if(f(e.name)){let t=a.find(t=>t.name===e.name);e.hasPath&&t?.type===`string`&&!s.has(`path:${e.expression}`)&&(s.add(`path:${e.expression}`),n.push({type:`system_variable_property_access`,severity:`error`,variable:e.name,message:`'${e.expression}' in ${e.tag} reads a property of system variable '${e.name}', which is a string (${t.description}). Use '${e.name}' directly.`}));continue}o.add(e.name),!i.has(e.name)&&!s.has(e.name)&&(s.add(e.name),n.push(R(e.name,`in ${e.tag}`)))}for(let e of r?.helperMisuses??[])n.push(e.problem===`used_as_value`?{type:`helper_used_as_value`,severity:`error`,variable:e.helper,message:`'${e.helper}' in ${e.tag} is a helper, but as an argument Handlebars reads it as data, which is empty. Call it as a subexpression: (${e.helper} ...).`}:{type:`helper_missing_arguments`,severity:`error`,variable:e.helper,message:`${e.tag} calls helper '${e.helper}' without arguments. Pass the value it operates on, e.g. {{${e.helper} value}}.`});n.push(...L(i,o,e=>`use it via {{${e}}}`));let c=t??{},l=M(e,c,I(c));return l.success||n.push({type:`handlebars_render_error`,severity:`error`,message:`Handlebars rendering failed: ${l.error}`}),n}function ce(e,t){let n=[],i=new Set(t?.properties?Object.keys(t.properties):[]),a;try{let t=l(e,{globals:[...r],acorn:{allowReturnOutsideFunction:!0,locations:!0}});a=t.vars;for(let e of t.errors)n.push({type:`jst_unsafe_construct`,severity:`error`,message:`JST validation error at ${e.location}: ${e.message}`})}catch(e){return n.push({type:`jst_render_error`,severity:`error`,message:`JST parse failed: ${e instanceof Error?e.message:String(e)}`}),n}for(let e of a)i.has(e)||n.push(R(e,`in the template`));if(n.push(...L(i,a,()=>`use it in the template`)),!n.some(e=>e.severity===`error`)){let r=t??{};try{m(e,[...i],I(r))}catch(e){n.push({type:`jst_render_error`,severity:`error`,message:`JST rendering failed: ${e instanceof Error?e.message:String(e)}`})}}return n}function z(e){let t;t=e.contentType===x.handlebars?se(e.content,e.inputSchema):e.contentType===x.jst?ce(e.content,e.inputSchema):[];let{error_count:n,warning_count:r}=F(t);return{issues:t,error_count:n,warning_count:r}}var B=class{name;domain;permissions;constructor(e,t,n){this.name=e,this.domain=n,this.permissions=new Set(t)}hasPermission(e){return this.permissions.has(e)}},V=class extends B{constructor(e,t){super(e,t,`system`)}},H=class extends B{applicableScopes;constructor(e,t,n,r){super(e,t,n),this.applicableScopes=r}};const U=`content`,W=[`document`,`collection`];var G;(function(e){e.content_reader=`content:reader`,e.content_writer=`content:writer`,e.content_manager=`content:manager`})(G||={});var le=class extends H{constructor(){super(G.content_reader,[`read`],U,W)}},ue=class extends H{constructor(){super(G.content_writer,[`read`,`write`],U,W)}},de=class extends H{constructor(){super(G.content_manager,[`read`,`write`,`delete`],U,W)}};const fe={[G.content_reader]:new le,[G.content_writer]:new ue,[G.content_manager]:new de},pe={domain:U,roles:new Map(Object.entries(fe))};var K=class extends V{constructor(e,t){super(e,[v.account_member,...t])}},q=class extends K{constructor(){super(b.owner,Object.values(v))}},J=class extends K{constructor(){super(b.admin,Object.values(v))}},me=class extends J{constructor(){super(),this.name=b.app_admin,this.permissions.delete(v.studio_access)}},he=class extends K{constructor(){super(b.manager,Object.values(v)),this.permissions.delete(v.account_admin),this.permissions.delete(v.manage_billing),this.permissions.delete(v.audit_read),this.permissions.delete(v.agent_run_read),this.permissions.delete(v.content_read_all),this.permissions.delete(v.content_superadmin),this.permissions.delete(v.workflow_superadmin)}},Y=class extends K{constructor(){super(b.developer,Object.values(v)),this.permissions.delete(v.account_admin),this.permissions.delete(v.project_admin),this.permissions.delete(v.project_settings_write),this.permissions.delete(v.env_admin),this.permissions.delete(v.manage_billing),this.permissions.delete(v.audit_read),this.permissions.delete(v.agent_run_read),this.permissions.delete(v.content_read_all),this.permissions.delete(v.content_superadmin),this.permissions.delete(v.workflow_superadmin)}},ge=class extends K{constructor(){super(b.application,[v.int_read,v.int_execute,v.int_write,v.run_read,v.content_write,v.content_read,v.content_write,v.content_admin,v.project_admin,v.workflow_run,v.project_settings_write,v.account_write])}},_e=class extends K{constructor(){super(b.automation,[v.content_read,v.content_write,v.content_admin,v.int_read,v.int_execute,v.run_read,v.workflow_run,v.project_integration_read])}},ve=class extends K{constructor(){super(b.content_processor,[v.content_read,v.content_write,v.content_admin,v.content_superadmin,v.int_execute,v.workflow_read,v.workflow_run,v.run_read])}},ye=class extends K{constructor(){super(b.consumer,[v.content_admin,v.content_read,v.content_write,v.content_delete,v.int_read,v.int_execute,v.run_read,v.workflow_run])}},be=class extends K{constructor(){super(b.executor,[v.int_execute,v.run_read,v.workflow_run])}},xe=class extends K{constructor(){super(b.reader,[v.int_read,v.run_read,v.content_read])}};const Se=[v.studio_access,v.account_read,v.project_integration_read,v.api_key_read,v.billing_read,v.audit_read,v.int_read,v.run_read,v.content_read,v.content_read_all,v.task_read,v.workflow_read,v.agent_run_read];var X=class extends K{constructor(e){super(e,Se)}},Ce=class extends K{constructor(){super(b.billing,[v.manage_billing])}},we=class extends K{constructor(){super(b.app_member,[v.int_read,v.int_execute,v.int_write,v.run_read,v.content_write,v.content_read,v.content_delete,v.workflow_run])}},Te=class extends Y{constructor(){super(),this.name=b.content_superadmin,this.permissions.add(v.content_superadmin)}};const Ee={[b.owner]:new q,[b.admin]:new J,[b.app_admin]:new me,[b.manager]:new he,[b.developer]:new Y,[b.application]:new ge,[b.automation]:new _e,[b.content_processor]:new ve,[b.consumer]:new ye,[b.executor]:new be,[b.reader]:new xe,[b.auditor]:new X(b.auditor),[b.support]:new X(b.support),[b.billing]:new Ce,[b.app_member]:new we,[b.member]:new K(b.member,[]),[b.content_superadmin]:new Te},Z=[{domain:`system`,roles:new Map(Object.entries(Ee))},pe];function Q(e){for(let t of Z){let n=t.roles.get(e);if(n)return n}throw Error(`Role ${e} not found`)}function $(){let e=[];for(let t of Z)for(let n of t.roles.values())e.push(n);return e}function De(e){let t=Z.find(t=>t.domain===e);return t?Array.from(t.roles.values()):[]}function Oe(e){return $().filter(t=>t instanceof H&&t.applicableScopes.includes(e))}function ke(){return $().filter(e=>e instanceof V)}function Ae(){return $().map(e=>e.name)}function je(e){let t=new Set;for(let n of e){let e=Q(n);for(let n of e.permissions)t.add(n)}return Array.from(t)}function Me(e){let t=Q(e);return t instanceof H?[...t.permissions].map(e=>`${t.domain}:${e}`):[...t.permissions]}var Ne=class e{roles;constructor(e){this.roles=e}static fromRoleNames(t){let n=t.map(e=>Q(e));return new e(n)}static fromRoleName(t){let n=[Q(t)];return new e(n)}hasPermission(e){return this.roles.some(t=>t.hasPermission(e))}};export{H as AbacRole,G as ContentRoleNames,n as HANDLEBARS_HELPER_NAMES,B as Role,Ne as RoleList,V as SystemRole,i as TEMPLATE_SYSTEM_VARIABLES,o as TEMPLATE_SYSTEM_VARIABLE_NAMES,D as analyzeHandlebarsTemplate,s as describeTemplateSystemVariables,M as executeHandlebars,j as executeJST,O as extractHandlebarsVariables,k as generateMockData,Ae as getAllRoleNames,Me as getDelegablePermissionsForRole,je as getPermissionsForRoles,Q as getRoleByName,d as isTemplateSystemVariable,Oe as listAbacRolesForScope,$ as listRoles,De as listRolesByDomain,ke as listSystemRoles,ie as renderPrompt,N as renderSegments,re as renderSegmentsOrErrors,A as renderTemplate,ee as substituteEndpoints,z as validatePrompt,h as withTemplateSystemVariables};
 //# sourceMappingURL=vertesia-studio-utils.js.map