@sf-explorer/agentscript-migration-tool 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2024-01-09
+
+### Added
+- Initial release of AgentScript Migration Tool
+- Core generator functionality (`AgentScriptGenerator` class)
+- Convenience function (`generateAgentScript`)
+- Comprehensive TypeScript type definitions
+- Input validation with `ValidationError` class
+- Support for all Salesforce action types (Flow, Apex, Standard Invocable, etc.)
+- YAML formatting following Salesforce Agent Script Recipes spec
+- Python-style boolean conversion (True/False)
+- Compact YAML format for variables and actions
+- Multi-line instruction formatting with `->` syntax
+- Name sanitization for topics and actions
+- Comprehensive test suite
+- Example code demonstrating usage
+- Full documentation
+
+### Features
+- ✅ 85% automated migration from UI-based to code-based AgentScript
+- ✅ Spec-compliant YAML generation
+- ✅ Type-safe TypeScript interfaces
+- ✅ Input validation and error handling
+- ✅ Framework-agnostic design
+- ✅ Zero runtime dependencies (except js-yaml)
+
+### Documentation
+- Complete README with examples
+- API documentation with JSDoc comments
+- Publishing guide
+- Example code in `/examples` directory

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SF Explorer Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,342 @@
+# @sf-explorer/agentscript-migration-tool
+
+Generate Salesforce Agent Script YAML from Agentforce planner configurations. This tool helps accelerate migration from UI-based Agentforce configurations to code-based AgentScript format.
+
+## Features
+
+- ✅ **85% Automated Migration** - Generate complete agent scripts automatically
+- ✅ **Spec Compliant** - Follows official [Salesforce Agent Script Recipes](https://developer.salesforce.com/sample-apps/agent-script-recipes/)
+- ✅ **Type Safe** - Full TypeScript support with comprehensive interfaces
+- ✅ **Zero Dependencies** - Only requires `js-yaml` for YAML generation
+- ✅ **Framework Agnostic** - Works with any data structure matching the planner interface
+
+## Installation
+
+```bash
+npm install @sf-explorer/agentscript-migration-tool
+```
+
+### Requirements
+
+- Node.js >= 18.x
+- TypeScript >= 5.3 (for TypeScript projects)
+
+## Quick Example
+
+```typescript
+import { generateAgentScript } from '@sf-explorer/agentscript-migration-tool'
+import type { PlannerDefinition } from '@sf-explorer/agentscript-migration-tool'
+
+const planner: PlannerDefinition = {
+  DeveloperName: "my_agent",
+  MasterLabel: "My Agent",
+  topics: [/* ... */]
+}
+
+const yaml = generateAgentScript(planner)
+console.log(yaml)
+```
+
+## Quick Start
+
+```typescript
+import { generateAgentScript } from '@sf-explorer/agentscript-migration-tool'
+import type { PlannerDefinition } from '@sf-explorer/agentscript-migration-tool'
+
+// Define your planner data
+const planner: PlannerDefinition = {
+  DeveloperName: "customer_service_agent",
+  MasterLabel: "Customer Service Agent",
+  Metadata: {
+    description: "Assists customers with their service requests"
+  },
+  topics: [
+    {
+      DeveloperName: "Orders",
+      MasterLabel: "Orders",
+      Description: "Handle order-related inquiries",
+      actions: [
+        {
+          DeveloperName: "LookupOrder",
+          MasterLabel: "Lookup Order",
+          Description: "Look up order by ID",
+          InvocationTarget: "GetOrderDetails",
+          InvocationTargetType: "Flow",
+          Metadata: {
+            inputs: {
+              order_id: "string"
+            },
+            outputs: {
+              order_summary: "string"
+            }
+          }
+        }
+      ]
+    }
+  ],
+  variables: [
+    {
+      DeveloperName: "customer_verified",
+      parameterName: "customer_verified",
+      mappingType: "Boolean",
+      description: "Whether customer is verified"
+    }
+  ]
+}
+
+// Generate Agent Script YAML
+const yaml = generateAgentScript(planner, {
+  includeComments: true,
+  includeLanguageConfig: true
+})
+
+console.log(yaml)
+```
+
+## API
+
+### `generateAgentScript(planner, options?)`
+
+Convenience function to generate Agent Script YAML.
+
+**Parameters:**
+- `planner: PlannerDefinition` - The planner definition object
+- `options?: AgentScriptGenerationOptions` - Optional generation options
+
+**Returns:** `string` - Generated YAML content
+
+### `AgentScriptGenerator`
+
+Class-based generator for more control.
+
+```typescript
+import { AgentScriptGenerator } from '@sf-explorer/agentscript-migration-tool'
+
+const generator = new AgentScriptGenerator(planner, {
+  includeComments: true,
+  yamlIndent: 4,
+  includeLanguageConfig: true
+})
+
+const yaml = generator.generate()
+```
+
+### Generation Options
+
+```typescript
+interface AgentScriptGenerationOptions {
+  includeComments?: boolean        // Add header comments (default: true)
+  includeExamples?: boolean       // Include example code (default: false)
+  yamlIndent?: number             // YAML indentation (default: 4)
+  generateVariables?: boolean     // Generate variables section (default: false)
+  includeLanguageConfig?: boolean // Include language block (default: true)
+}
+```
+
+## Generated Structure
+
+The tool generates complete Agent Script YAML following Salesforce patterns:
+
+- **Config Block**: Agent metadata and configuration
+- **System Block**: Global instructions and messages
+- **Language Block**: Locale configuration (optional)
+- **Variables**: State management variables (if provided)
+- **Start Agent**: Topic selector with transitions
+- **Topics**: Individual topics with reasoning and actions
+- **Actions**: External integrations (Flow, Apex, API)
+
+### Example Output
+
+```yaml
+# Agent Script
+# Generated from GenAI Planner: Customer Service Agent
+# Developer Name: customer_service_agent
+
+config:
+    developer_name: "customer_service_agent"
+    default_agent_user: "agentforce@salesforce.com"
+    description: "Assists customers with their service requests"
+
+system:
+    instructions: "You are a helpful assistant..."
+    messages:
+        welcome: "Hi, I'm your Customer Service Agent assistant..."
+        error: "Sorry, something went wrong..."
+
+variables:
+    customer_verified: mutable boolean
+        description: "Whether customer is verified"
+
+start_agent topic_selector:
+    description: "Welcome the user and determine the appropriate topic"
+    reasoning:
+        instructions: ->
+            | You are a topic selector assistant...
+        actions:
+            go_to_orders: @utils.transition to @topic.Orders
+                description: "Handle order-related inquiries"
+
+topic Orders:
+    description: "Handle order-related inquiries"
+    reasoning:
+        instructions: ->
+            | Handle order-related inquiries.
+            
+            Available actions:
+            - Use @actions.LookupOrder to Look up order by ID
+        actions:
+            LookupOrder: @actions.LookupOrder
+                description: "Look up order by ID"
+    actions:
+        LookupOrder:
+            description: "Look up order by ID"
+            inputs:
+                order_id: string
+            outputs:
+                order_summary: string
+            target: "flow://GetOrderDetails"
+```
+
+## Type Definitions
+
+The package exports comprehensive TypeScript types:
+
+- `PlannerDefinition` - Main input interface
+- `PlannerTopic` - Topic definition
+- `PlannerAction` - Action definition
+- `PlannerVariable` - Variable definition
+- `AgentScriptStructure` - Generated YAML structure
+- `AgentScriptGenerationOptions` - Generation options
+
+See the [types.ts](./src/types.ts) file for complete definitions.
+
+## Supported Action Types
+
+The tool automatically formats action targets based on type:
+
+- **Flow**: `flow://FlowName`
+- **Apex**: `apex://ClassName`
+- **Standard Invocable Action**: `standardInvocableAction://ActionName`
+- **Generate Prompt Response**: `generatePromptResponse://TemplateName`
+- **External Service**: `externalService://ServiceName`
+- **Custom Protocols**: Preserved as-is
+
+## Migration Workflow
+
+1. **Extract Planner Data** - Get your planner configuration from Salesforce
+2. **Transform to Interface** - Map your data to `PlannerDefinition` interface
+3. **Generate YAML** - Use `generateAgentScript()` to create YAML
+4. **Review & Customize** - Add business logic and detailed instructions
+5. **Deploy** - Deploy to Salesforce using Salesforce CLI
+
+## Best Practices
+
+### 1. Start Small
+Begin with 1-2 non-critical agents to learn the patterns.
+
+### 2. Review Generated Code
+The generated script is 85% complete. Review and add:
+- Detailed reasoning instructions
+- Specific business rules
+- Custom error handling
+- Advanced routing logic
+
+### 3. Test Thoroughly
+Always test in sandbox before production:
+- Compare behavior with UI version
+- Validate all topics
+- Check action parameters
+- Test error scenarios
+
+### 4. Version Control
+Treat AgentScript like any code:
+- Use Git for version control
+- Code reviews
+- Feature branches
+- Documentation
+
+## Based on Salesforce Patterns
+
+This implementation follows the official [Salesforce Agent Script Recipes](https://developer.salesforce.com/sample-apps/agent-script-recipes/getting-started/overview) including:
+
+- **Language Essentials**: HelloWorld, VariableManagement, TemplateExpressions
+- **Action Configuration**: ActionDefinitions, ActionCallbacks, AdvancedInputBindings
+- **Architectural Patterns**: MultiTopicNavigation, SimpleQA, BidirectionalNavigation
+- **Reasoning Mechanics**: ReasoningInstructions, BeforeAfterReasoning
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Submit a pull request
+
+## License
+
+MIT
+
+## References
+
+- [Salesforce Agent Script Recipes](https://developer.salesforce.com/sample-apps/agent-script-recipes/getting-started/overview)
+- [Agentforce Documentation](https://developer.salesforce.com/docs/einstein/genai/guide/)
+- [Agent Script Syntax Guide](https://developer.salesforce.com/sample-apps/agent-script-recipes/)
+
+## Error Handling
+
+The package includes comprehensive error handling:
+
+```typescript
+import { generateAgentScript, ValidationError } from '@sf-explorer/agentscript-migration-tool'
+
+try {
+  const yaml = generateAgentScript(planner)
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.error('Validation error:', error.message)
+    console.error('Field:', error.field)
+  } else {
+    console.error('Generation error:', error)
+  }
+}
+```
+
+## Testing
+
+Run the test suite:
+
+```bash
+npm test
+```
+
+Run tests with coverage:
+
+```bash
+npm run test:coverage
+```
+
+## Support
+
+For issues or questions:
+
+1. Check the [official recipes](https://developer.salesforce.com/sample-apps/agent-script-recipes/getting-started/overview)
+2. Review the [examples](./examples/) directory
+3. Review type definitions in `types.ts`
+4. Examine generator implementation in `generator.ts`
+5. Open an issue on GitHub
+
+## Contributing
+
+Contributions are welcome! Please see our contributing guidelines:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure all tests pass (`npm test`)
+6. Commit your changes (`git commit -m 'Add amazing feature'`)
+7. Push to the branch (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+# agentscript-migration-tool

package/dist/builders/actionBuilder.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Action Builder
+ * Builds action definitions for Agent Script
+ */
+import type { PlannerAction, AgentScriptActionDefinition } from "../types";
+/**
+ * Build action target
+ * Formats target string based on invocation type
+ * Supports: flow://, apex://, standardInvocableAction://, generatePromptResponse://, and other protocols
+ *
+ * @param action - The action definition
+ * @returns Formatted target string
+ */
+export declare function buildActionTarget(action: PlannerAction): string;
+/**
+ * Build action inputs
+ * Extracts or generates input parameters
+ *
+ * @param action - The action definition
+ * @returns Record of input parameter definitions
+ */
+export declare function buildActionInputs(action: PlannerAction): Record<string, string>;
+/**
+ * Build action outputs
+ * Extracts or generates output parameters
+ *
+ * @param action - The action definition
+ * @returns Record of output parameter definitions
+ */
+export declare function buildActionOutputs(action: PlannerAction): Record<string, string | Record<string, unknown>>;
+/**
+ * Build action definition
+ * Converts PlannerAction to Agent Script action
+ *
+ * @param action - The action definition
+ * @returns AgentScriptActionDefinition
+ */
+export declare function buildAction(action: PlannerAction): AgentScriptActionDefinition;
+//# sourceMappingURL=actionBuilder.d.ts.map

package/dist/builders/actionBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/actionBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AAG1E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA0C/D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBlD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,GACpB,2BAA2B,CAO7B"}

package/dist/builders/actionBuilder.js

@@ -0,0 +1,120 @@
+/**
+ * Action Builder
+ * Builds action definitions for Agent Script
+ */
+import { cleanDeveloperName } from "../utils/nameSanitizer";
+/**
+ * Build action target
+ * Formats target string based on invocation type
+ * Supports: flow://, apex://, standardInvocableAction://, generatePromptResponse://, and other protocols
+ *
+ * @param action - The action definition
+ * @returns Formatted target string
+ */
+export function buildActionTarget(action) {
+    if (action.InvocationTarget) {
+        const target = action.InvocationTarget;
+        const targetType = action.InvocationTargetType || "";
+        // If target already has a protocol, return as-is
+        if (target.includes("://") ||
+            target.startsWith("@") ||
+            target.startsWith("flow://") ||
+            target.startsWith("apex://") ||
+            target.startsWith("standardInvocableAction://") ||
+            target.startsWith("generatePromptResponse://")) {
+            return target;
+        }
+        // Map target type to protocol
+        switch (targetType.toLowerCase()) {
+            case "generatepromptresponse":
+                return `generatePromptResponse://${target}`;
+            case "flow":
+                return `flow://${cleanDeveloperName(action.DeveloperName || target)}`;
+            case "apex":
+                return `apex://${action.DeveloperName || target}`;
+            case "standardinvocableaction":
+                // For knowledge actions, use Source field if available (e.g., "KnowledgeArticleVersion")
+                // Otherwise use InvocationTarget
+                const source = action.Source;
+                const actionTarget = source || target;
+                return `standardInvocableAction://${actionTarget}`;
+            case "externalservice":
+                return `externalService://${cleanDeveloperName(action.DeveloperName || target)}`;
+            default:
+                // If target type is not recognized, return the target as-is
+                // (it might be a URL or other valid target)
+                return target;
+        }
+    }
+    // No InvocationTarget provided - use default
+    return "flow://DefaultFlow";
+}
+/**
+ * Build action inputs
+ * Extracts or generates input parameters
+ *
+ * @param action - The action definition
+ * @returns Record of input parameter definitions
+ */
+export function buildActionInputs(action) {
+    const inputs = {};
+    // Try to extract from metadata
+    if (action.Metadata) {
+        const metadata = action.Metadata;
+        if (metadata.inputs) {
+            Object.entries(metadata.inputs).forEach(([key, value]) => {
+                inputs[key] = typeof value === "string" ? value : "string";
+            });
+        }
+    }
+    // Default input if none found
+    if (Object.keys(inputs).length === 0) {
+        inputs.query = "string";
+    }
+    return inputs;
+}
+/**
+ * Build action outputs
+ * Extracts or generates output parameters
+ *
+ * @param action - The action definition
+ * @returns Record of output parameter definitions
+ */
+export function buildActionOutputs(action) {
+    const outputs = {};
+    // Try to extract from metadata
+    if (action.Metadata) {
+        const metadata = action.Metadata;
+        if (metadata.outputs) {
+            Object.entries(metadata.outputs).forEach(([key, value]) => {
+                if (typeof value === "object" && value !== null) {
+                    outputs[key] = value;
+                }
+                else {
+                    outputs[key] = typeof value === "string" ? value : "string";
+                }
+            });
+        }
+    }
+    // Default output if none found
+    if (Object.keys(outputs).length === 0) {
+        outputs.result = "string";
+    }
+    return outputs;
+}
+/**
+ * Build action definition
+ * Converts PlannerAction to Agent Script action
+ *
+ * @param action - The action definition
+ * @returns AgentScriptActionDefinition
+ */
+export function buildAction(action) {
+    return {
+        description: action.Description || "Performs an action",
+        inputs: buildActionInputs(action),
+        outputs: buildActionOutputs(action),
+        target: buildActionTarget(action),
+    };
+}
+//# sourceMappingURL=actionBuilder.js.map

package/dist/builders/actionBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionBuilder.js","sourceRoot":"","sources":["../../src/builders/actionBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAA;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAA;QAEpD,iDAAiD;QACjD,IACE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACtB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;YACtB,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;YAC5B,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;YAC5B,MAAM,CAAC,UAAU,CAAC,4BAA4B,CAAC;YAC/C,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,EAC9C,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,8BAA8B;QAC9B,QAAQ,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YACjC,KAAK,wBAAwB;gBAC3B,OAAO,4BAA4B,MAAM,EAAE,CAAA;YAC7C,KAAK,MAAM;gBACT,OAAO,UAAU,kBAAkB,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,EAAE,CAAA;YACvE,KAAK,MAAM;gBACT,OAAO,UAAU,MAAM,CAAC,aAAa,IAAI,MAAM,EAAE,CAAA;YACnD,KAAK,yBAAyB;gBAC5B,yFAAyF;gBACzF,iCAAiC;gBACjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;gBAC5B,MAAM,YAAY,GAAG,MAAM,IAAI,MAAM,CAAA;gBACrC,OAAO,6BAA6B,YAAY,EAAE,CAAA;YACpD,KAAK,iBAAiB;gBACpB,OAAO,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,EAAE,CAAA;YAClF;gBACE,4DAA4D;gBAC5D,4CAA4C;gBAC5C,OAAO,MAAM,CAAA;QACjB,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,OAAO,oBAAoB,CAAA;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAqB;IAErB,MAAM,MAAM,GAA2B,EAAE,CAAA;IAEzC,+BAA+B;IAC/B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;QAChC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBACvD,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;YAC5D,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAA;IACzB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAqB;IAErB,MAAM,OAAO,GAAqD,EAAE,CAAA;IAEpE,+BAA+B;IAC/B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;QAChC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAChD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAgC,CAAA;gBACjD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;gBAC7D,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAA;IAC3B,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,MAAqB;IAErB,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,oBAAoB;QACvD,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;QACjC,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC;QACnC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;KAClC,CAAA;AACH,CAAC"}

package/dist/builders/configBuilder.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Config Block Builder
+ * Builds the config block for Agent Script
+ */
+import type { PlannerDefinition, AgentScriptConfig } from "../types";
+/**
+ * Build config block
+ * Defines agent metadata
+ *
+ * @param planner - The planner definition
+ * @returns AgentScriptConfig object
+ */
+export declare function buildConfig(planner: PlannerDefinition): AgentScriptConfig;
+//# sourceMappingURL=configBuilder.d.ts.map

package/dist/builders/configBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/configBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAGpE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAYzE"}

package/dist/builders/configBuilder.js

@@ -0,0 +1,22 @@
+/**
+ * Config Block Builder
+ * Builds the config block for Agent Script
+ */
+import { sanitizeString } from "../validation";
+/**
+ * Build config block
+ * Defines agent metadata
+ *
+ * @param planner - The planner definition
+ * @returns AgentScriptConfig object
+ */
+export function buildConfig(planner) {
+    const developerName = sanitizeString(planner.DeveloperName || "agent_assistant");
+    const description = sanitizeString(planner.Metadata?.description || "AI-powered assistant for your needs.");
+    return {
+        developer_name: developerName,
+        default_agent_user: "agentforce@salesforce.com",
+        description: description,
+    };
+}
+//# sourceMappingURL=configBuilder.js.map

package/dist/builders/configBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configBuilder.js","sourceRoot":"","sources":["../../src/builders/configBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAA0B;IACpD,MAAM,aAAa,GACjB,cAAc,CAAC,OAAO,CAAC,aAAa,IAAI,iBAAiB,CAAC,CAAA;IAC5D,MAAM,WAAW,GAAG,cAAc,CAChC,OAAO,CAAC,QAAQ,EAAE,WAAW,IAAI,sCAAsC,CACxE,CAAA;IAED,OAAO;QACL,cAAc,EAAE,aAAa;QAC7B,kBAAkB,EAAE,2BAA2B;QAC/C,WAAW,EAAE,WAAW;KACzB,CAAA;AACH,CAAC"}

package/dist/builders/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Builder Module Exports
+ * Centralized exports for all builder functions
+ */
+export * from "./configBuilder";
+export * from "./systemBuilder";
+export * from "./languageBuilder";
+export * from "./variablesBuilder";
+export * from "./topicBuilder";
+export * from "./actionBuilder";
+export * from "./startAgentBuilder";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builders/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA"}

package/dist/builders/index.js

@@ -0,0 +1,12 @@
+/**
+ * Builder Module Exports
+ * Centralized exports for all builder functions
+ */
+export * from "./configBuilder";
+export * from "./systemBuilder";
+export * from "./languageBuilder";
+export * from "./variablesBuilder";
+export * from "./topicBuilder";
+export * from "./actionBuilder";
+export * from "./startAgentBuilder";
+//# sourceMappingURL=index.js.map

package/dist/builders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builders/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA"}

package/dist/builders/languageBuilder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Language Block Builder
+ * Builds the language block for Agent Script
+ */
+import type { AgentScriptLanguageBlock } from "../types";
+/**
+ * Build language block
+ * Defines locale configuration
+ *
+ * @returns AgentScriptLanguageBlock object
+ */
+export declare function buildLanguage(): AgentScriptLanguageBlock;
+//# sourceMappingURL=languageBuilder.d.ts.map

package/dist/builders/languageBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languageBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/languageBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,wBAAwB,CAMxD"}