@sf-explorer/agentscript-migration-tool 1.0.0

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAEjB,4BAA4B,EAC7B,MAAM,SAAS,CAAA;AAiBhB;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAwC;IAEvD;;;;;OAKG;gBAED,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,4BAAiC;IAgB5C;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAmBlB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CA8BzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,4BAA4B,GACrC,MAAM,CAGR"}

package/dist/generator.js

@@ -0,0 +1,109 @@
+/**
+ * Agent Script Generator
+ * Generates Salesforce Agent Script YAML from PlannerDefinition
+ * Based on official Salesforce Agent Script Recipes
+ * @see https://developer.salesforce.com/sample-apps/agent-script-recipes/getting-started/overview
+ */
+import { validatePlannerDefinition, validateIndent, ValidationError, } from "./validation";
+import { buildConfig, buildSystem, buildLanguage, buildVariables, buildStartAgent, buildTopic, } from "./builders";
+import { convertToYaml } from "./formatters";
+import { sanitizeTopicName } from "./utils";
+/**
+ * AgentScriptGenerator
+ * Generates complete Agent Script YAML following Salesforce patterns
+ *
+ * @example
+ * ```typescript
+ * const generator = new AgentScriptGenerator(planner, {
+ *   includeComments: true,
+ *   yamlIndent: 4
+ * })
+ * const yaml = generator.generate()
+ * ```
+ */
+export class AgentScriptGenerator {
+    /**
+     * Creates a new AgentScriptGenerator instance
+     * @param planner - The planner definition to generate YAML from
+     * @param options - Optional generation options
+     * @throws {ValidationError} If the planner definition is invalid
+     */
+    constructor(planner, options = {}) {
+        // Validate input
+        validatePlannerDefinition(planner);
+        this.planner = planner;
+        const validatedIndent = validateIndent(options.yamlIndent ?? 4);
+        this.options = {
+            includeComments: options.includeComments ?? true,
+            includeExamples: options.includeExamples ?? false,
+            yamlIndent: validatedIndent,
+            generateVariables: options.generateVariables ?? false,
+            includeLanguageConfig: options.includeLanguageConfig ?? true,
+        };
+    }
+    /**
+     * Generate complete Agent Script YAML
+     * @returns Generated YAML string
+     * @throws {Error} If generation fails
+     */
+    generate() {
+        try {
+            const agentScript = this.buildAgentScript();
+            return convertToYaml(agentScript, this.options, this.planner.MasterLabel, this.planner.DeveloperName);
+        }
+        catch (error) {
+            if (error instanceof ValidationError) {
+                throw error;
+            }
+            throw new Error(`Failed to generate Agent Script: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Build the complete agent script structure
+     * @returns Complete AgentScriptStructure
+     */
+    buildAgentScript() {
+        const script = {
+            config: buildConfig(this.planner),
+            system: buildSystem(this.planner),
+        };
+        // Add optional language configuration
+        if (this.options.includeLanguageConfig) {
+            script.language = buildLanguage();
+        }
+        // Add variables if they exist
+        if (this.planner.variables && this.planner.variables.length > 0) {
+            script.variables = buildVariables(this.planner);
+        }
+        // Add start_agent topic selector (with named sub-topic)
+        script["start_agent topic_selector"] = buildStartAgent(this.planner);
+        // Add individual topics (with 'topic' prefix per Salesforce spec)
+        const topics = this.planner.topics || [];
+        topics.forEach((topic, index) => {
+            const topicName = sanitizeTopicName(topic.DeveloperName || topic.MasterLabel || `Topic_${index}`);
+            script[`topic ${topicName}`] = buildTopic(topic);
+        });
+        return script;
+    }
+}
+/**
+ * Convenience function to generate Agent Script YAML
+ *
+ * @param planner - The planner definition to generate YAML from
+ * @param options - Optional generation options
+ * @returns Generated YAML string
+ * @throws {ValidationError} If the planner definition is invalid
+ *
+ * @example
+ * ```typescript
+ * const yaml = generateAgentScript(planner, {
+ *   includeComments: true,
+ *   includeLanguageConfig: true
+ * })
+ * ```
+ */
+export function generateAgentScript(planner, options) {
+    const generator = new AgentScriptGenerator(planner, options);
+    return generator.generate();
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAoB;IAI/B;;;;;OAKG;IACH,YACE,OAA0B,EAC1B,UAAwC,EAAE;QAE1C,iBAAiB;QACjB,yBAAyB,CAAC,OAAO,CAAC,CAAA;QAElC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,CAAA;QAC/D,IAAI,CAAC,OAAO,GAAG;YACb,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;YAChD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;YACjD,UAAU,EAAE,eAAe;YAC3B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,KAAK;YACrD,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,IAAI;SAC7D,CAAA;IACH,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;YAC3C,OAAO,aAAa,CAClB,WAAW,EACX,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,OAAO,CAAC,WAAW,EACxB,IAAI,CAAC,OAAO,CAAC,aAAa,CAC3B,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACrC,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,IAAI,KAAK,CACb,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7F,CAAA;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,gBAAgB;QACtB,MAAM,MAAM,GAAyB;YACnC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;YACjC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;SAClC,CAAA;QAED,sCAAsC;QACtC,IAAI,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;YACvC,MAAM,CAAC,QAAQ,GAAG,aAAa,EAAE,CAAA;QACnC,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACjD,CAAC;QAED,wDAAwD;QACxD,MAAM,CAAC,4BAA4B,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAEpE,kEAAkE;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAA;QACxC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC9B,MAAM,SAAS,GAAG,iBAAiB,CACjC,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,IAAI,SAAS,KAAK,EAAE,CAC7D,CAAA;YACD,MAAM,CAAC,SAAS,SAAS,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;QAClD,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA0B,EAC1B,OAAsC;IAEtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC5D,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAA;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Agent Script Migration Tool
+ * Generates Salesforce Agent Script YAML from PlannerDefinition
+ *
+ * Based on official Salesforce Agent Script Recipes
+ * @see https://developer.salesforce.com/sample-apps/agent-script-recipes/getting-started/overview
+ *
+ * @packageDocumentation
+ */
+export * from "./types";
+export * from "./generator";
+export * from "./validation";
+export { AgentScriptGenerator, generateAgentScript } from "./generator";
+export { ValidationError } from "./validation";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * Agent Script Migration Tool
+ * Generates Salesforce Agent Script YAML from PlannerDefinition
+ *
+ * Based on official Salesforce Agent Script Recipes
+ * @see https://developer.salesforce.com/sample-apps/agent-script-recipes/getting-started/overview
+ *
+ * @packageDocumentation
+ */
+export * from "./types";
+export * from "./generator";
+export * from "./validation";
+export { AgentScriptGenerator, generateAgentScript } from "./generator";
+export { ValidationError } from "./validation";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Agent Script Types
+ * Based on Salesforce Agent Script Recipes
+ * @see https://developer.salesforce.com/sample-apps/agent-script-recipes/getting-started/overview
+ */
+/**
+ * Agent Script Config Block
+ * Defines agent metadata and configuration
+ */
+export interface AgentScriptConfig {
+    agent_name?: string;
+    developer_name: string;
+    default_agent_user?: string;
+    description?: string;
+}
+/**
+ * Agent Script System Block
+ * Defines global settings and instructions
+ */
+export interface AgentScriptSystemBlock {
+    instructions: string;
+    messages?: {
+        welcome?: string;
+        error?: string;
+        [key: string]: string | undefined;
+    };
+    system_instructions?: string;
+}
+/**
+ * Agent Script Variable Declaration
+ * Defines state management
+ */
+export interface AgentScriptVariable {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    mutable: boolean;
+    linked?: boolean;
+    default?: string | number | boolean | Record<string, unknown> | unknown[];
+    description?: string;
+}
+/**
+ * Agent Script Language Block
+ * Defines locale configuration
+ */
+export interface AgentScriptLanguageBlock {
+    default_locale: string;
+    additional_locales?: string;
+    all_additional_locales?: boolean;
+}
+/**
+ * Agent Script Action Definition
+ * Defines external integrations (Flow, Apex, API)
+ */
+export interface AgentScriptActionDefinition {
+    description: string;
+    inputs?: Record<string, string>;
+    outputs?: Record<string, string | {
+        description?: string;
+        [key: string]: unknown;
+    }>;
+    target: string;
+}
+/**
+ * Agent Script Reasoning Action
+ * Actions available to LLM in reasoning block
+ */
+export interface AgentScriptReasoningAction {
+    action?: string;
+    description?: string;
+    available_when?: string;
+    with?: Record<string, unknown>;
+    set?: Record<string, unknown>;
+}
+/**
+ * Agent Script Reasoning Block
+ * Defines topic behavior and available actions
+ */
+export interface AgentScriptReasoningBlock {
+    instructions?: string | string[];
+    actions?: Record<string, AgentScriptReasoningAction | string>;
+    before_reasoning?: string;
+    after_reasoning?: string;
+}
+/**
+ * Agent Script Topic Block
+ * Defines individual topics with reasoning and actions
+ */
+export interface AgentScriptTopicBlock {
+    description: string;
+    reasoning?: AgentScriptReasoningBlock;
+    actions?: Record<string, AgentScriptActionDefinition>;
+    system_instructions?: string;
+}
+/**
+ * Complete Agent Script Structure
+ * Following official Salesforce Agent Script format
+ */
+export interface AgentScriptStructure {
+    config: AgentScriptConfig;
+    system: AgentScriptSystemBlock;
+    variables?: Record<string, AgentScriptVariable>;
+    language?: AgentScriptLanguageBlock;
+    start_agent?: AgentScriptTopicBlock;
+    [topicName: string]: unknown;
+}
+/**
+ * Agent Script Generation Options
+ */
+export interface AgentScriptGenerationOptions {
+    includeComments?: boolean;
+    includeExamples?: boolean;
+    yamlIndent?: number;
+    generateVariables?: boolean;
+    includeLanguageConfig?: boolean;
+}
+/**
+ * Abstract interfaces for planner data structures
+ * These replace the Salesforce model dependencies
+ */
+/**
+ * Represents a variable/attribute definition
+ */
+export interface PlannerVariable {
+    Id?: string;
+    DeveloperName?: string;
+    parameterName?: string;
+    mappingType?: string;
+    description?: string;
+}
+/**
+ * Represents an action/function definition
+ */
+export interface PlannerAction {
+    Id?: string;
+    DeveloperName?: string;
+    MasterLabel?: string;
+    Description?: string;
+    InvocationTarget?: string;
+    InvocationTargetType?: string;
+    Source?: string;
+    Metadata?: {
+        inputs?: Record<string, string>;
+        outputs?: Record<string, string | Record<string, unknown>>;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Represents a topic/plugin definition
+ */
+export interface PlannerTopic {
+    Id?: string;
+    DeveloperName?: string;
+    MasterLabel?: string;
+    Description?: string;
+    Scope?: string;
+    actions?: PlannerAction[];
+    Metadata?: {
+        description?: string;
+        scope?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Represents a planner definition
+ * This is the main input to the generator
+ */
+export interface PlannerDefinition {
+    Id?: string;
+    MasterLabel?: string;
+    DeveloperName?: string;
+    topics?: PlannerTopic[];
+    actions?: PlannerAction[];
+    variables?: PlannerVariable[];
+    Metadata?: {
+        description?: string;
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Agent Script Types
+ * Based on Salesforce Agent Script Recipes
+ * @see https://developer.salesforce.com/sample-apps/agent-script-recipes/getting-started/overview
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Utilities Module Exports
+ */
+export * from "./nameSanitizer";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+/**
+ * Utilities Module Exports
+ */
+export * from "./nameSanitizer";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAA"}

package/dist/utils/nameSanitizer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Name Sanitization Utilities
+ * Provides functions to sanitize names for Agent Script compatibility
+ */
+/**
+ * Clean developer name by removing ID suffix
+ * Removes pattern: underscore followed by alphanumeric ID (typically 15-18 chars)
+ * e.g., "MyAction_16ja0590c168ff0" -> "MyAction"
+ *
+ * @param name - The developer name to clean
+ * @returns Cleaned developer name without ID suffix
+ */
+export declare function cleanDeveloperName(name: string): string;
+/**
+ * Sanitize topic name for Agent Script
+ * Removes IDs and converts to valid identifier (alphanumeric + underscores)
+ *
+ * @param name - The topic name to sanitize
+ * @returns Sanitized topic name
+ */
+export declare function sanitizeTopicName(name: string): string;
+/**
+ * Sanitize action name for Agent Script
+ * Removes IDs and converts to valid identifier (alphanumeric + underscores)
+ *
+ * @param name - The action name to sanitize
+ * @returns Sanitized action name
+ */
+export declare function sanitizeActionName(name: string): string;
+//# sourceMappingURL=nameSanitizer.d.ts.map

package/dist/utils/nameSanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameSanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/nameSanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BtD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BvD"}

package/dist/utils/nameSanitizer.js

@@ -0,0 +1,76 @@
+/**
+ * Name Sanitization Utilities
+ * Provides functions to sanitize names for Agent Script compatibility
+ */
+/**
+ * Clean developer name by removing ID suffix
+ * Removes pattern: underscore followed by alphanumeric ID (typically 15-18 chars)
+ * e.g., "MyAction_16ja0590c168ff0" -> "MyAction"
+ *
+ * @param name - The developer name to clean
+ * @returns Cleaned developer name without ID suffix
+ */
+export function cleanDeveloperName(name) {
+    return name.replace(/_[a-zA-Z0-9]{12,18}$/, "");
+}
+/**
+ * Sanitize topic name for Agent Script
+ * Removes IDs and converts to valid identifier (alphanumeric + underscores)
+ *
+ * @param name - The topic name to sanitize
+ * @returns Sanitized topic name
+ */
+export function sanitizeTopicName(name) {
+    // Remove common ID patterns (e.g., __c, _12345, UUID-like patterns)
+    let cleaned = name
+        // Remove __c suffix
+        .replace(/__c$/i, "")
+        // Remove trailing IDs like _12345 or _abc123
+        .replace(/_[a-zA-Z0-9]{5,}$/i, "")
+        // Remove UUID-like patterns
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, "")
+        // Remove standalone numbers at the end
+        .replace(/_\d+$/g, "");
+    // Convert to valid identifier (alphanumeric + underscores only)
+    cleaned = cleaned.replace(/[^a-zA-Z0-9_]/g, "_");
+    // Remove multiple consecutive underscores
+    cleaned = cleaned.replace(/_+/g, "_");
+    // Remove leading/trailing underscores
+    cleaned = cleaned.replace(/^_+|_+$/g, "");
+    // Ensure it starts with a letter (add prefix if it doesn't)
+    if (cleaned && !/^[a-zA-Z]/.test(cleaned)) {
+        cleaned = "topic_" + cleaned;
+    }
+    return cleaned || "topic";
+}
+/**
+ * Sanitize action name for Agent Script
+ * Removes IDs and converts to valid identifier (alphanumeric + underscores)
+ *
+ * @param name - The action name to sanitize
+ * @returns Sanitized action name
+ */
+export function sanitizeActionName(name) {
+    // Remove common ID patterns
+    let cleaned = name
+        // Remove __c suffix
+        .replace(/__c$/i, "")
+        // Remove trailing IDs like _12345 or _abc123
+        .replace(/_[a-zA-Z0-9]{5,}$/i, "")
+        // Remove UUID-like patterns
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, "")
+        // Remove standalone numbers at the end
+        .replace(/_\d+$/g, "");
+    // Convert to valid identifier (alphanumeric + underscores only)
+    cleaned = cleaned.replace(/[^a-zA-Z0-9_]/g, "_");
+    // Remove multiple consecutive underscores
+    cleaned = cleaned.replace(/_+/g, "_");
+    // Remove leading/trailing underscores
+    cleaned = cleaned.replace(/^_+|_+$/g, "");
+    // Ensure it starts with a letter (add prefix if it doesn't)
+    if (cleaned && !/^[a-zA-Z]/.test(cleaned)) {
+        cleaned = "action_" + cleaned;
+    }
+    return cleaned || "action";
+}
+//# sourceMappingURL=nameSanitizer.js.map

package/dist/utils/nameSanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameSanitizer.js","sourceRoot":"","sources":["../../src/utils/nameSanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,oEAAoE;IACpE,IAAI,OAAO,GAAG,IAAI;QAChB,oBAAoB;SACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACrB,6CAA6C;SAC5C,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAClC,4BAA4B;SAC3B,OAAO,CACN,gEAAgE,EAChE,EAAE,CACH;QACD,uCAAuC;SACtC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAExB,gEAAgE;IAChE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAA;IAEhD,0CAA0C;IAC1C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAErC,sCAAsC;IACtC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAEzC,4DAA4D;IAC5D,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC9B,CAAC;IAED,OAAO,OAAO,IAAI,OAAO,CAAA;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,4BAA4B;IAC5B,IAAI,OAAO,GAAG,IAAI;QAChB,oBAAoB;SACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACrB,6CAA6C;SAC5C,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAClC,4BAA4B;SAC3B,OAAO,CACN,gEAAgE,EAChE,EAAE,CACH;QACD,uCAAuC;SACtC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAExB,gEAAgE;IAChE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAA;IAEhD,0CAA0C;IAC1C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAErC,sCAAsC;IACtC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAEzC,4DAA4D;IAC5D,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IAC/B,CAAC;IAED,OAAO,OAAO,IAAI,QAAQ,CAAA;AAC5B,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Validation utilities for AgentScript Generator
+ * Provides input validation and error handling
+ */
+import type { PlannerDefinition, PlannerTopic, PlannerAction } from "./types";
+/**
+ * Custom error class for validation errors
+ */
+export declare class ValidationError extends Error {
+    readonly field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+/**
+ * Validates a PlannerDefinition object
+ * @param planner - The planner definition to validate
+ * @throws {ValidationError} If validation fails
+ */
+export declare function validatePlannerDefinition(planner: unknown): asserts planner is PlannerDefinition;
+/**
+ * Validates a PlannerTopic object
+ * @param topic - The topic to validate
+ * @param index - Optional index for error reporting
+ * @throws {ValidationError} If validation fails
+ */
+export declare function validateTopic(topic: unknown, index?: number): asserts topic is PlannerTopic;
+/**
+ * Validates a PlannerAction object
+ * @param action - The action to validate
+ * @param topicIndex - Optional topic index for error reporting
+ * @param actionIndex - Optional action index for error reporting
+ * @throws {ValidationError} If validation fails
+ */
+export declare function validateAction(action: unknown, topicIndex?: number, actionIndex?: number): asserts action is PlannerAction;
+/**
+ * Sanitizes a string to ensure it's safe for use in YAML
+ * @param value - The string to sanitize
+ * @returns Sanitized string
+ */
+export declare function sanitizeString(value: string): string;
+/**
+ * Validates YAML indentation value
+ * @param indent - The indentation value to validate
+ * @returns Valid indentation value (defaults to 4)
+ */
+export declare function validateIndent(indent: unknown): number;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE7E;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aACK,KAAK,CAAC,EAAE,MAAM;gBAA/C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,MAAM,YAAA;CAK5D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,IAAI,iBAAiB,CAmCtC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,IAAI,YAAY,CA8B/B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,IAAI,aAAa,CAwBjC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAWtD"}

package/dist/validation.js

@@ -0,0 +1,123 @@
+/**
+ * Validation utilities for AgentScript Generator
+ * Provides input validation and error handling
+ */
+/**
+ * Custom error class for validation errors
+ */
+export class ValidationError extends Error {
+    constructor(message, field) {
+        super(message);
+        this.field = field;
+        this.name = "ValidationError";
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+/**
+ * Validates a PlannerDefinition object
+ * @param planner - The planner definition to validate
+ * @throws {ValidationError} If validation fails
+ */
+export function validatePlannerDefinition(planner) {
+    if (!planner || typeof planner !== "object") {
+        throw new ValidationError("Planner definition must be an object", "planner");
+    }
+    const p = planner;
+    // Validate required fields
+    if (!p.DeveloperName && !p.MasterLabel) {
+        throw new ValidationError("Planner must have either DeveloperName or MasterLabel", "DeveloperName|MasterLabel");
+    }
+    // Validate topics if provided
+    if (p.topics !== undefined) {
+        if (!Array.isArray(p.topics)) {
+            throw new ValidationError("Topics must be an array", "topics");
+        }
+        p.topics.forEach((topic, index) => {
+            validateTopic(topic, index);
+        });
+    }
+    // Validate variables if provided
+    if (p.variables !== undefined) {
+        if (!Array.isArray(p.variables)) {
+            throw new ValidationError("Variables must be an array", "variables");
+        }
+    }
+}
+/**
+ * Validates a PlannerTopic object
+ * @param topic - The topic to validate
+ * @param index - Optional index for error reporting
+ * @throws {ValidationError} If validation fails
+ */
+export function validateTopic(topic, index) {
+    if (!topic || typeof topic !== "object") {
+        throw new ValidationError(`Topic at index ${index ?? "unknown"} must be an object`, `topics[${index ?? "?"}]`);
+    }
+    const t = topic;
+    if (!t.DeveloperName && !t.MasterLabel) {
+        throw new ValidationError(`Topic at index ${index ?? "unknown"} must have either DeveloperName or MasterLabel`, `topics[${index ?? "?"}].DeveloperName|MasterLabel`);
+    }
+    // Validate actions if provided
+    if (t.actions !== undefined) {
+        if (!Array.isArray(t.actions)) {
+            throw new ValidationError(`Topic actions at index ${index ?? "unknown"} must be an array`, `topics[${index ?? "?"}].actions`);
+        }
+        t.actions.forEach((action, actionIndex) => {
+            validateAction(action, index, actionIndex);
+        });
+    }
+}
+/**
+ * Validates a PlannerAction object
+ * @param action - The action to validate
+ * @param topicIndex - Optional topic index for error reporting
+ * @param actionIndex - Optional action index for error reporting
+ * @throws {ValidationError} If validation fails
+ */
+export function validateAction(action, topicIndex, actionIndex) {
+    if (!action || typeof action !== "object") {
+        const path = topicIndex !== undefined && actionIndex !== undefined
+            ? `topics[${topicIndex}].actions[${actionIndex}]`
+            : "action";
+        throw new ValidationError(`${path} must be an object`, path);
+    }
+    const a = action;
+    if (!a.DeveloperName && !a.MasterLabel) {
+        const path = topicIndex !== undefined && actionIndex !== undefined
+            ? `topics[${topicIndex}].actions[${actionIndex}]`
+            : "action";
+        throw new ValidationError(`${path} must have either DeveloperName or MasterLabel`, `${path}.DeveloperName|MasterLabel`);
+    }
+    // Warn if no InvocationTarget (but don't fail validation)
+    if (!a.InvocationTarget && !a.InvocationTargetType) {
+        // This is acceptable - will use default
+    }
+}
+/**
+ * Sanitizes a string to ensure it's safe for use in YAML
+ * @param value - The string to sanitize
+ * @returns Sanitized string
+ */
+export function sanitizeString(value) {
+    if (typeof value !== "string") {
+        return String(value);
+    }
+    // Remove null bytes and other control characters except newlines
+    return value.replace(/[\x00-\x08\x0B-\x0C\x0E-\x1F\x7F]/g, "");
+}
+/**
+ * Validates YAML indentation value
+ * @param indent - The indentation value to validate
+ * @returns Valid indentation value (defaults to 4)
+ */
+export function validateIndent(indent) {
+    if (typeof indent === "number") {
+        if (indent < 1 || indent > 10) {
+            console.warn(`[AgentScript] Invalid indent value ${indent}. Using default: 4`);
+            return 4;
+        }
+        return indent;
+    }
+    return 4;
+}
+//# sourceMappingURL=validation.js.map