Validation History: sf-ai-agentscript

Validation History: sf-ai-agentscript

This file tracks the validation history of the sf-ai-agentscript skill. Validation agents are deployed to a test org to verify that documented patterns still work with current Salesforce releases.

Latest Validation

Validation Agent Results

Total Duration: ~171.6s

Patterns Validated

Each validation agent tests specific patterns documented in SKILL.md:

1. Val_Minimal_Syntax → Core Syntax

   • config block with agent_name, agent_label, default_agent_user
   • system block with messages and instructions
   • start_agent block with reasoning and actions
   • topic block with description and reasoning

2. Val_Arithmetic_Ops → Expression Operators

   • Addition: @variables.counter + 1
   • Subtraction: @variables.counter - 1
   • Note: *, /, % are NOT supported

3. Val_Comparison_Ops → Expression Operators

   • Equality: ==, not-equal (<> or not-equal-operator)
   • Comparisons: <, <=, >, >=
   • Logical: and, or, not

4. Val_Variable_Scopes → Variable Namespaces

   • mutable string with default value
   • mutable number with default value
   • mutable boolean with default value
   • set @variables.x = value assignment

5. Val_Topic_Transitions → Topic Transitions

   • @utils.transition to @topic.X (permanent handoff)
   • Multi-step topic chains

6. Val_Latch_Pattern → Production Gotchas

   • Boolean flag initialization
   • Setting latch on entry
   • Checking latch in topic selector
   • Clearing latch on completion

7. Val_Loop_Guard → Production Gotchas

   • Iteration counter pattern
   • available when guard clause
   • Exit condition on max iterations

8. Val_Interpolation → Instruction Syntax

   • Basic interpolation: {!@variables.x}
   • Multiple variables in string
   • Conditional interpolation: {!value if condition else alt}

Validation Command

# Navigate to validation directory
cd sf-ai-agentscript/validation

# Deploy metadata first
sf project deploy start \
  --source-dir validation-agents/force-app/main/default/aiAuthoringBundles \
  --target-org R6-Agentforce-SandboxFull

# Publish each agent
for agent in Val_Minimal_Syntax Val_Arithmetic_Ops Val_Comparison_Ops Val_Variable_Scopes Val_Topic_Transitions Val_Latch_Pattern Val_Loop_Guard Val_Interpolation; do
  sf agent publish authoring-bundle --api-name "$agent" --target-org R6-Agentforce-SandboxFull
done

History

Next Validation Due

2026-02-19 (30 days from last validation)

Troubleshooting

If Validation Fails

1. Check the error message - Salesforce will indicate what syntax changed
2. Update SKILL.md - Document the new constraint or syntax requirement
3. Fix the validation agent - Update to use correct syntax
4. Re-run validation - Ensure all agents pass again
5. Update this file - Log the issue and resolution in History

Common Issues