Replace deprecated method in craftStory with recommendated approach. Update docs with env info.

Author: Jasper Blues

README.md

@@ -24,6 +24,13 @@ Add your magic here!
 
 # To run
 
+Create at least one of the following in your env pointing to a valid key:
+
+```bash
+export OPENAI_API_KEY=YOUR_OPENAI_KEY
+export ANTHROPIC_API_KEY=YOUR_ANTHROPIC_API_KEY
+```
+
 Run the shell script to start Embabel under Spring Shell:
 
 ```bash

src/main/kotlin/com/embabel/template/agent/WriteAndReviewAgent.kt

@@ -84,22 +84,18 @@ class WriteAndReviewAgent(
 ) {
 
     @Action
-    fun craftStory(userInput: UserInput): Story =
-        using(
-            LlmOptions(criteria = Auto)
-                .withTemperature(.9), // Higher temperature for more creative output
-        ).withPromptContributor(StoryTeller)
-            .create(
-                """
+    fun craftStory(userInput: UserInput, context: OperationContext): Story =
+        context.promptRunner().withLlm(LlmOptions(criteria = Auto, temperature = 0.9))
+            .withPromptContributor(StoryTeller)
+            .create<Story>("""
             Craft a short story in $storyWordCount words or less.
             The story should be engaging and imaginative.
             Use the user's input as inspiration if possible.
             If the user has provided a name, include it in the story.
 
             # User input
             ${userInput.content}
-        """.trimIndent()
-            )
+        """.trimIndent())
 
     @AchievesGoal(
         description = "The user has been greeted",

src/test/kotlin/com/embabel/template/agent/WriteAndReviewAgentTest.kt

@@ -2,6 +2,7 @@ package com.embabel.template.agent
 
 import com.embabel.agent.domain.io.UserInput
 import com.embabel.agent.testing.unit.FakeOperationContext
+import com.embabel.agent.testing.unit.FakePromptRunner
 import com.embabel.agent.testing.unit.LlmInvocation
 import com.embabel.agent.testing.unit.UnitTestUtils.captureLlmCall
 import org.junit.jupiter.api.Assertions
@@ -22,22 +23,27 @@ internal class WriteAndReviewAgentTest {
     fun testCraftStory() {
         // Create agent with word limits: 200 min, 400 max
         val agent = WriteAndReviewAgent(200, 400)
+        val context = FakeOperationContext.create()
+        val promptRunner = context.promptRunner() as FakePromptRunner
+
+        context.expectResponse(Story("One upon a time Sir Galahad . . "))
 
-        // Capture the LLM call made during story crafting
-        val llmCall = captureLlmCall(Runnable {
-            agent.craftStory(UserInput("Tell me a story about a brave knight", Instant.now()))
-        })
+        agent.craftStory(
+            UserInput("Tell me a story about a brave knight", Instant.now()),
+            context
+        )
 
         // Verify the prompt contains the expected keyword
         Assertions.assertTrue(
-            llmCall.prompt.contains("knight"),
+            promptRunner.llmInvocations.first().prompt.contains("knight"),
             "Expected prompt to contain 'knight'"
         )
 
 
         // Verify the temperature setting for creative output
+        val actual = promptRunner.llmInvocations.first().interaction.llm.temperature
         Assertions.assertEquals(
-            0.9, llmCall.llm!!.temperature, 0.01,
+            0.9, actual, 0.01,
             "Expected temperature to be 0.9: Higher for more creative output"
         )
     }