@sensigo/realm 0.1.0

package/dist/workflow/template-resolver.d.ts

@@ -0,0 +1,25 @@
+import type { TemplateDefinition, StepDefinition } from '../types/workflow-definition.js';
+/**
+ * Resolves {{ key }} placeholders in a string value.
+ * Unknown placeholders are left as-is (forward compat for nested templates in future).
+ */
+export declare function resolvePlaceholders(value: string, vars: Record<string, string>): string;
+/**
+ * Recursively walks an object and applies resolvePlaceholders to all string leaf values.
+ * Does not modify keys — only values.
+ */
+export declare function resolveObject(obj: unknown, vars: Record<string, string>): unknown;
+/**
+ * Expands a single use_template instantiation into concrete named steps.
+ * Returns an array of [stepId, stepDef] pairs in template declaration order.
+ */
+export declare function expandTemplateInstantiation(callSiteKey: string, instantiation: Record<string, unknown>, templates: Record<string, TemplateDefinition>): Array<[string, StepDefinition]>;
+/**
+ * Walks the raw steps object and replaces any use_template entries with their
+ * expanded concrete steps. Returns a new steps Record in the same order, with
+ * template instantiations expanded inline at the position of the call site key.
+ *
+ * Called by loadWorkflowFromString before per-step validation.
+ */
+export declare function resolveTemplates(rawSteps: Record<string, unknown>, templates: Record<string, TemplateDefinition>): Record<string, unknown>;
+//# sourceMappingURL=template-resolver.d.ts.map

package/dist/workflow/template-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-resolver.d.ts","sourceRoot":"","sources":["../../src/workflow/template-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAG1F;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIvF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CASjF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC5C,KAAK,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CA0DjC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB"}

package/dist/workflow/template-resolver.js

@@ -0,0 +1,112 @@
+// Template resolver — expands use_template steps into concrete steps before validation.
+import { WorkflowError } from '../types/workflow-error.js';
+/**
+ * Resolves {{ key }} placeholders in a string value.
+ * Unknown placeholders are left as-is (forward compat for nested templates in future).
+ */
+export function resolvePlaceholders(value, vars) {
+    return value.replace(/\{\{\s*([\w]+)\s*\}\}/g, (match, key) => {
+        return key in vars ? vars[key] : match;
+    });
+}
+/**
+ * Recursively walks an object and applies resolvePlaceholders to all string leaf values.
+ * Does not modify keys — only values.
+ */
+export function resolveObject(obj, vars) {
+    if (typeof obj === 'string')
+        return resolvePlaceholders(obj, vars);
+    if (Array.isArray(obj))
+        return obj.map((item) => resolveObject(item, vars));
+    if (typeof obj === 'object' && obj !== null) {
+        return Object.fromEntries(Object.entries(obj).map(([k, v]) => [k, resolveObject(v, vars)]));
+    }
+    return obj;
+}
+/**
+ * Expands a single use_template instantiation into concrete named steps.
+ * Returns an array of [stepId, stepDef] pairs in template declaration order.
+ */
+export function expandTemplateInstantiation(callSiteKey, instantiation, templates) {
+    const templateName = instantiation['use_template'];
+    const template = templates[templateName];
+    if (template === undefined) {
+        throw new WorkflowError(`Step '${callSiteKey}': use_template references unknown template '${templateName}'`, {
+            code: 'VALIDATION_WORKFLOW_SCHEMA',
+            category: 'VALIDATION',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    const prefix = instantiation['prefix'];
+    if (typeof prefix !== 'string' || prefix === '') {
+        throw new WorkflowError(`Step '${callSiteKey}': use_template requires a non-empty 'prefix'`, {
+            code: 'VALIDATION_WORKFLOW_SCHEMA',
+            category: 'VALIDATION',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    // Resolve params: merge caller-supplied values with template defaults.
+    const callerParams = (instantiation['params'] ?? {});
+    const vars = { prefix };
+    const paramErrors = [];
+    for (const [paramName, paramDef] of Object.entries(template.params ?? {})) {
+        const supplied = callerParams[paramName];
+        if (supplied !== undefined) {
+            vars[paramName] = String(supplied);
+        }
+        else if (paramDef.default !== undefined) {
+            vars[paramName] = paramDef.default;
+        }
+        else if (paramDef.required === true) {
+            paramErrors.push(`Step '${callSiteKey}': template '${templateName}' requires param '${paramName}'`);
+        }
+    }
+    if (paramErrors.length > 0) {
+        throw new WorkflowError(`Invalid workflow: ${paramErrors.join('; ')}`, {
+            code: 'VALIDATION_WORKFLOW_SCHEMA',
+            category: 'VALIDATION',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    // Expand template steps: prefix_templateStepName → resolved StepDefinition.
+    return Object.entries(template.steps).map(([templateStepName, templateStep]) => {
+        const stepId = `${prefix}_${templateStepName}`;
+        const resolved = resolveObject(templateStep, vars);
+        return [stepId, resolved];
+    });
+}
+/**
+ * Walks the raw steps object and replaces any use_template entries with their
+ * expanded concrete steps. Returns a new steps Record in the same order, with
+ * template instantiations expanded inline at the position of the call site key.
+ *
+ * Called by loadWorkflowFromString before per-step validation.
+ */
+export function resolveTemplates(rawSteps, templates) {
+    const resolved = {};
+    for (const [key, value] of Object.entries(rawSteps)) {
+        const stepRaw = value;
+        if ('use_template' in stepRaw) {
+            const expanded = expandTemplateInstantiation(key, stepRaw, templates);
+            for (const [expandedId, expandedStep] of expanded) {
+                if (expandedId in resolved) {
+                    throw new WorkflowError(`Template expansion produced duplicate step ID '${expandedId}'`, {
+                        code: 'VALIDATION_WORKFLOW_SCHEMA',
+                        category: 'VALIDATION',
+                        agentAction: 'report_to_user',
+                        retryable: false,
+                    });
+                }
+                resolved[expandedId] = expandedStep;
+            }
+        }
+        else {
+            resolved[key] = value;
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=template-resolver.js.map

package/dist/workflow/template-resolver.js.map

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

package/dist/workflow/yaml-loader.d.ts

@@ -0,0 +1,15 @@
+import type { WorkflowDefinition } from '../types/workflow-definition.js';
+/** Bumped on every breaking change to WorkflowDefinition's serialized format. */
+export declare const CURRENT_WORKFLOW_SCHEMA_VERSION = 1;
+/**
+ * Loads a WorkflowDefinition from a YAML file on disk.
+ * @throws WorkflowError on read failure or structural validation errors.
+ */
+export declare function loadWorkflowFromFile(filePath: string): WorkflowDefinition;
+/**
+ * Loads a WorkflowDefinition from a YAML string.
+ * Validates structure and DAG dependency references.
+ * @throws WorkflowError on parse failure or structural validation errors.
+ */
+export declare function loadWorkflowFromString(content: string): WorkflowDefinition;
+//# sourceMappingURL=yaml-loader.d.ts.map

package/dist/workflow/yaml-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.d.ts","sourceRoot":"","sources":["../../src/workflow/yaml-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,iCAAiC,CAAC;AAIzC,iFAAiF;AACjF,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAajD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CA+HzE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAqW1E"}

package/dist/workflow/yaml-loader.js

@@ -0,0 +1,408 @@
+// Workflow YAML loader — parses workflow.yaml files into typed WorkflowDefinition objects.
+import { readFileSync, existsSync } from 'node:fs';
+import { dirname, resolve, join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { load } from 'js-yaml';
+import { WorkflowError } from '../types/workflow-error.js';
+import { resolveTemplates } from './template-resolver.js';
+/** Bumped on every breaking change to WorkflowDefinition's serialized format. */
+export const CURRENT_WORKFLOW_SCHEMA_VERSION = 1;
+const VALID_EXECUTIONS = new Set(['auto', 'agent']);
+const VALID_SERVICE_METHODS = new Set(['fetch', 'create', 'update', 'delete']);
+const VALID_TRIGGER_RULES = new Set([
+    'all_success',
+    'all_failed',
+    'all_done',
+    'one_failed',
+    'one_success',
+    'none_failed',
+]);
+/**
+ * Loads a WorkflowDefinition from a YAML file on disk.
+ * @throws WorkflowError on read failure or structural validation errors.
+ */
+export function loadWorkflowFromFile(filePath) {
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new WorkflowError(`Failed to read workflow file: ${message}`, {
+            code: 'RESOURCE_FETCH_FAILED',
+            category: 'RESOURCE',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    const definition = loadWorkflowFromString(content);
+    // Resolve agent profiles — only possible when we have a file path.
+    const workflowDir = dirname(resolve(filePath));
+    const profilesDir = definition.profiles_dir !== undefined
+        ? resolve(workflowDir, definition.profiles_dir)
+        : join(workflowDir, 'profiles');
+    const resolvedProfiles = {};
+    const profileErrors = [];
+    for (const [stepName, step] of Object.entries(definition.steps)) {
+        if (step.agent_profile === undefined)
+            continue;
+        const profileName = step.agent_profile;
+        if (profileName in resolvedProfiles)
+            continue;
+        const profilePath = join(profilesDir, `${profileName}.md`);
+        let profileContent;
+        try {
+            profileContent = readFileSync(profilePath, 'utf8');
+        }
+        catch {
+            profileErrors.push(`Step '${stepName}': agent_profile '${profileName}' not found. Searched: ${profilePath}`);
+            continue;
+        }
+        const contentHash = createHash('sha256').update(profileContent).digest('hex');
+        resolvedProfiles[profileName] = { content: profileContent, content_hash: contentHash };
+    }
+    if (profileErrors.length > 0) {
+        throw new WorkflowError(`Invalid workflow: ${profileErrors.join('; ')}`, {
+            code: 'VALIDATION_WORKFLOW_SCHEMA',
+            category: 'VALIDATION',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    if (Object.keys(resolvedProfiles).length > 0) {
+        definition.resolved_profiles = resolvedProfiles;
+    }
+    // Validate context_wrapper if present.
+    if (definition.context_wrapper !== undefined) {
+        const VALID_WRAPPER_FORMATS = new Set(['xml', 'brackets', 'none']);
+        if (!VALID_WRAPPER_FORMATS.has(definition.context_wrapper)) {
+            throw new WorkflowError(`Invalid context_wrapper '${String(definition.context_wrapper)}'; must be 'xml', 'brackets', or 'none'`, {
+                code: 'VALIDATION_WORKFLOW_SCHEMA',
+                category: 'VALIDATION',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+    }
+    // Validate and resolve workflow_context entry paths.
+    if (definition.workflow_context !== undefined) {
+        for (const [name, entry] of Object.entries(definition.workflow_context)) {
+            if (name.endsWith('.raw')) {
+                throw new WorkflowError(`workflow_context entry names must not end with '.raw' (found: '${name}')`, {
+                    code: 'VALIDATION_WORKFLOW_SCHEMA',
+                    category: 'VALIDATION',
+                    agentAction: 'report_to_user',
+                    retryable: false,
+                });
+            }
+            if (!/^[\w.]+$/.test(name)) {
+                throw new WorkflowError(`workflow_context entry name '${name}' is invalid; names must match [\\w.]+ (underscores and dots only — no hyphens)`, {
+                    code: 'VALIDATION_WORKFLOW_SCHEMA',
+                    category: 'VALIDATION',
+                    agentAction: 'report_to_user',
+                    retryable: false,
+                });
+            }
+            const rawEntry = entry;
+            const rawSource = rawEntry['source'];
+            if (rawSource === undefined || typeof rawSource['path'] !== 'string') {
+                throw new WorkflowError(`workflow_context.${name}.source.path is required`, {
+                    code: 'VALIDATION_WORKFLOW_SCHEMA',
+                    category: 'VALIDATION',
+                    agentAction: 'report_to_user',
+                    retryable: false,
+                });
+            }
+            // Resolve relative path to absolute.
+            entry.source.path = resolve(workflowDir, rawSource['path']);
+        }
+    }
+    // Auto-register schema.json if present and not explicitly declared.
+    const schemaPath = join(workflowDir, 'schema.json');
+    if (existsSync(schemaPath) && definition.workflow_context?.['schema'] === undefined) {
+        definition.workflow_context ??= {};
+        definition.workflow_context['schema'] = {
+            source: { path: schemaPath },
+            description: 'Auto-registered schema.json from workflow directory',
+        };
+    }
+    definition.origin = 'human';
+    return definition;
+}
+/**
+ * Loads a WorkflowDefinition from a YAML string.
+ * Validates structure and DAG dependency references.
+ * @throws WorkflowError on parse failure or structural validation errors.
+ */
+export function loadWorkflowFromString(content) {
+    // Step 1: Parse YAML
+    let raw;
+    try {
+        raw = load(content);
+    }
+    catch (err) {
+        throw new WorkflowError(`YAML parse error: ${err instanceof Error ? err.message : String(err)}`, {
+            code: 'RESOURCE_FORMAT_INVALID',
+            category: 'RESOURCE',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    const errors = [];
+    // Step 2: Top-level validation
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new WorkflowError('Invalid workflow: Workflow must be a non-null object', {
+            code: 'VALIDATION_WORKFLOW_SCHEMA',
+            category: 'VALIDATION',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    const doc = raw;
+    const REQUIRED_TOP_LEVEL = ['id', 'name', 'version', 'steps'];
+    for (const field of REQUIRED_TOP_LEVEL) {
+        if (!(field in doc)) {
+            errors.push(`Missing required field: '${field}'`);
+        }
+    }
+    if ('version' in doc && typeof doc['version'] !== 'number') {
+        errors.push(`'version' must be a number`);
+    }
+    if ('steps' in doc &&
+        (typeof doc['steps'] !== 'object' || doc['steps'] === null || Array.isArray(doc['steps']))) {
+        errors.push(`'steps' must be a non-null object`);
+    }
+    if (errors.length > 0) {
+        throw new WorkflowError(`Invalid workflow: ${errors.join('; ')}`, {
+            code: 'VALIDATION_WORKFLOW_SCHEMA',
+            category: 'VALIDATION',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    // Step 1b: Resolve template instantiations before validation.
+    const rawTemplates = (doc['templates'] ?? {});
+    if (Object.keys(rawTemplates).length > 0 || hasUseTemplateInSteps(doc['steps'])) {
+        doc['steps'] = resolveTemplates(doc['steps'], rawTemplates);
+    }
+    const stepsRaw = doc['steps'];
+    // Step 3: Per-step validation
+    for (const [stepName, stepRaw] of Object.entries(stepsRaw)) {
+        if (typeof stepRaw !== 'object' || stepRaw === null || Array.isArray(stepRaw)) {
+            errors.push(`Step '${stepName}' must be an object`);
+            continue;
+        }
+        const step = stepRaw;
+        const REQUIRED_STEP = ['description', 'execution'];
+        for (const field of REQUIRED_STEP) {
+            if (!(field in step)) {
+                errors.push(`Step '${stepName}': missing required field '${field}'`);
+            }
+        }
+        if ('execution' in step && !VALID_EXECUTIONS.has(step['execution'])) {
+            errors.push(`Step '${stepName}': invalid execution value '${String(step['execution'])}'; must be 'auto' or 'agent'`);
+        }
+        // agent_profile is only valid on agent steps.
+        if ('agent_profile' in step && step['execution'] !== 'agent') {
+            errors.push(`Step '${stepName}': 'agent_profile' is only valid on execution: agent steps`);
+        }
+        // output_schema is only valid on execution: agent steps.
+        if (step['output_schema'] !== undefined && step['execution'] !== 'agent') {
+            errors.push(`Step '${stepName}': 'output_schema' is only valid on execution: agent steps`);
+        }
+        // trace_schema is only valid on execution: agent steps.
+        if (step['trace_schema'] !== undefined && step['execution'] !== 'agent') {
+            errors.push(`Step '${stepName}': 'trace_schema' is only valid on execution: agent steps`);
+        }
+        // trace_validation_mode is only valid on execution: agent steps.
+        if (step['trace_validation_mode'] !== undefined && step['execution'] !== 'agent') {
+            errors.push(`Step '${stepName}': 'trace_validation_mode' is only valid on execution: agent steps`);
+        }
+        // trace_validation_mode must be 'warn' or 'enforce' when provided.
+        if (step['trace_validation_mode'] !== undefined &&
+            step['trace_validation_mode'] !== 'warn' &&
+            step['trace_validation_mode'] !== 'enforce') {
+            errors.push(`Step '${stepName}': invalid trace_validation_mode '${String(step['trace_validation_mode'])}'; must be 'warn' or 'enforce'`);
+        }
+        if ('uses_service' in step && typeof step['uses_service'] === 'string') {
+            const services = doc['services'];
+            if (typeof services !== 'object' ||
+                services === null ||
+                !(step['uses_service'] in services)) {
+                errors.push(`Step '${stepName}': uses_service '${step['uses_service']}' is not defined in 'services'`);
+            }
+        }
+        // Validate retry: backoff must be a recognised value when present.
+        if (step['retry'] !== undefined) {
+            if (typeof step['retry'] !== 'object' || step['retry'] === null) {
+                errors.push(`Step '${stepName}': 'retry' must be an object`);
+            }
+            else {
+                const retry = step['retry'];
+                if ('backoff' in retry &&
+                    retry['backoff'] !== 'fixed' &&
+                    retry['backoff'] !== 'linear' &&
+                    retry['backoff'] !== 'exponential') {
+                    errors.push(`Step '${stepName}': 'retry.backoff' must be 'fixed', 'linear', or 'exponential'`);
+                }
+                if ('max_attempts' in retry &&
+                    (!Number.isInteger(retry['max_attempts']) || retry['max_attempts'] < 1)) {
+                    errors.push(`Step '${stepName}': 'retry.max_attempts' must be a positive integer`);
+                }
+                if ('base_delay_ms' in retry &&
+                    (typeof retry['base_delay_ms'] !== 'number' || retry['base_delay_ms'] < 0)) {
+                    errors.push(`Step '${stepName}': 'retry.base_delay_ms' must be a non-negative number`);
+                }
+                if ('max_delay_ms' in retry &&
+                    (typeof retry['max_delay_ms'] !== 'number' || retry['max_delay_ms'] < 0)) {
+                    errors.push(`Step '${stepName}': 'retry.max_delay_ms' must be a non-negative number`);
+                }
+            }
+        }
+        if ('service_method' in step && !VALID_SERVICE_METHODS.has(step['service_method'])) {
+            errors.push(`Step '${stepName}': invalid service_method '${String(step['service_method'])}'; must be 'fetch', 'create', 'update', or 'delete'`);
+        }
+        // Validate input_map: only valid on execution: auto steps with uses_service.
+        if (step['input_map'] !== undefined) {
+            if (step['execution'] !== 'auto' || step['uses_service'] === undefined) {
+                errors.push(`Step '${stepName}': 'input_map' is only valid on execution: auto steps with uses_service`);
+            }
+        }
+        // Validate trigger_rule.
+        if ('trigger_rule' in step) {
+            if (!VALID_TRIGGER_RULES.has(step['trigger_rule'])) {
+                errors.push(`Step '${stepName}': invalid trigger_rule '${String(step['trigger_rule'])}'; must be one of ${[...VALID_TRIGGER_RULES].join(', ')}`);
+            }
+        }
+        // Validate depends_on: must be an array of existing step names.
+        if ('depends_on' in step && step['depends_on'] !== undefined) {
+            if (!Array.isArray(step['depends_on'])) {
+                errors.push(`Step '${stepName}': 'depends_on' must be an array`);
+            }
+            else {
+                for (const dep of step['depends_on']) {
+                    if (typeof dep !== 'string') {
+                        errors.push(`Step '${stepName}': depends_on entries must be strings`);
+                    }
+                    else if (dep === stepName) {
+                        errors.push(`Step '${stepName}': a step cannot depend on itself`);
+                    }
+                    else if (!(dep in stepsRaw)) {
+                        errors.push(`Step '${stepName}': depends_on references unknown step '${dep}'`);
+                    }
+                }
+            }
+        }
+        // Validate when: must be a non-empty string.
+        if ('when' in step && step['when'] !== undefined) {
+            if (typeof step['when'] !== 'string' || step['when'].trim() === '') {
+                errors.push(`Step '${stepName}': 'when' must be a non-empty string`);
+            }
+        }
+        // Validate tools: only valid on execution: agent steps without handler.
+        if (step['tools'] !== undefined &&
+            (step['execution'] !== 'agent' || step['handler'] !== undefined)) {
+            errors.push(`Step '${stepName}': 'tools' is only valid on execution: agent steps without 'handler' defined`);
+        }
+        // Validate tools: requires input_schema.
+        if (step['tools'] !== undefined && step['input_schema'] === undefined) {
+            errors.push(`Step '${stepName}': 'tools' requires 'input_schema' to be defined — the agentic loop needs a schema for final output extraction`);
+        }
+        // Validate tools: entries must be in server_id:tool_name format.
+        if (step['tools'] !== undefined && Array.isArray(step['tools'])) {
+            for (const entry of step['tools']) {
+                if (!/^[^:]+:[^:]+$/.test(entry)) {
+                    errors.push(`Step '${stepName}': tools entry '${entry}' must be in 'server_id:tool_name' format`);
+                }
+            }
+        }
+        // Validate tools: server_id must reference a defined mcp_server.
+        if (step['tools'] !== undefined &&
+            Array.isArray(step['tools']) &&
+            Array.isArray(doc['mcp_servers'])) {
+            const serverIds = new Set(doc['mcp_servers'].map((s) => s.id));
+            for (const entry of step['tools']) {
+                const serverId = entry.split(':')[0] ?? '';
+                if (!serverIds.has(serverId)) {
+                    errors.push(`Step '${stepName}': tools entry '${entry}' references unknown MCP server '${serverId}'`);
+                }
+            }
+        }
+        // Validate max_tool_calls: must be a positive integer.
+        if (step['max_tool_calls'] !== undefined &&
+            (!Number.isInteger(step['max_tool_calls']) || step['max_tool_calls'] <= 0)) {
+            errors.push(`Step '${stepName}': 'max_tool_calls' must be a positive integer`);
+        }
+        // Validate tool_timeout: must be a positive integer.
+        if (step['tool_timeout'] !== undefined &&
+            (!Number.isInteger(step['tool_timeout']) || step['tool_timeout'] <= 0)) {
+            errors.push(`Step '${stepName}': 'tool_timeout' must be a positive integer`);
+        }
+    }
+    // Validate mcp_servers: ids must be unique (workflow-level check).
+    if (Array.isArray(doc['mcp_servers'])) {
+        const seen = new Set();
+        for (const server of doc['mcp_servers']) {
+            if (seen.has(server.id)) {
+                errors.push(`mcp_servers: duplicate server id '${server.id}'`);
+            }
+            seen.add(server.id);
+        }
+    }
+    // Validate services: rate_limit fields.
+    if (typeof doc['services'] === 'object' && doc['services'] !== null) {
+        for (const [serviceName, serviceRaw] of Object.entries(doc['services'])) {
+            if (typeof serviceRaw !== 'object' || serviceRaw === null)
+                continue;
+            const service = serviceRaw;
+            const rateLimit = service['rate_limit'];
+            if (rateLimit === undefined)
+                continue;
+            if (typeof rateLimit !== 'object' || rateLimit === null) {
+                errors.push(`Service '${serviceName}': 'rate_limit' must be an object`);
+                continue;
+            }
+            const rl = rateLimit;
+            if ('requests_per_second' in rl &&
+                (!Number.isInteger(rl['requests_per_second']) || rl['requests_per_second'] < 1)) {
+                errors.push(`Service '${serviceName}': 'rate_limit.requests_per_second' must be a positive integer (≥ 1)`);
+            }
+            if ('burst' in rl) {
+                if (!Number.isInteger(rl['burst']) || rl['burst'] < 1) {
+                    errors.push(`Service '${serviceName}': 'rate_limit.burst' must be a positive integer (≥ 1)`);
+                }
+                if (!('requests_per_second' in rl)) {
+                    errors.push(`Service '${serviceName}': 'rate_limit.burst' requires 'rate_limit.requests_per_second' to be set`);
+                }
+            }
+            if ('fallback_retry_seconds' in rl &&
+                (typeof rl['fallback_retry_seconds'] !== 'number' ||
+                    rl['fallback_retry_seconds'] <= 0)) {
+                errors.push(`Service '${serviceName}': 'rate_limit.fallback_retry_seconds' must be a positive number (> 0)`);
+            }
+            if ('max_retry_seconds' in rl &&
+                (!Number.isInteger(rl['max_retry_seconds']) || rl['max_retry_seconds'] < 1)) {
+                errors.push(`Service '${serviceName}': 'rate_limit.max_retry_seconds' must be a positive integer (≥ 1)`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new WorkflowError(`Invalid workflow: ${errors.join('; ')}`, {
+            code: 'VALIDATION_WORKFLOW_SCHEMA',
+            category: 'VALIDATION',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    // Step 4: Stamp schema version and return typed result
+    const definition = doc;
+    definition.schema_version = CURRENT_WORKFLOW_SCHEMA_VERSION;
+    return definition;
+}
+/** Returns true if any step in the raw steps map declares use_template. */
+function hasUseTemplateInSteps(steps) {
+    if (typeof steps !== 'object' || steps === null)
+        return false;
+    return Object.values(steps).some((s) => typeof s === 'object' && s !== null && 'use_template' in s);
+}
+//# sourceMappingURL=yaml-loader.js.map

package/dist/workflow/yaml-loader.js.map

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