extrait 0.3.1 → 0.5.1

package/README.md

@@ -128,6 +128,16 @@ const result = await llm.structured(
     .user`Analyze: """${input}"""`
 );
 
+// Multi-turn conversation
+const conversationResult = await llm.structured(
+  Schema,
+  prompt()
+    .system`You are an expert assistant.`
+    .user`Hello`
+    .assistant`Hi, how can I help?`
+    .user`Analyze: """${input}"""`
+);
+
 // With options
 const result = await llm.structured(
   Schema,
@@ -136,6 +146,7 @@ const result = await llm.structured(
     mode: "loose",
     selfHeal: 1,
     debug: true,
+    systemPrompt: "You are a helpful assistant.",
     stream: {
       to: "stdout",
       onData: (event) => {
@@ -145,10 +156,15 @@ const result = await llm.structured(
         }
       },
     },
+    request: {
+      signal: abortController.signal,  // optional AbortSignal
+    },
   }
 );
 ```
 
+`prompt()` builds an ordered `messages` payload. Use `prompt\`...\`` for a single string prompt, or the fluent builder for multi-turn conversations. The `LLMMessage` type is exported if you need to type your own message arrays.
+
 ### Result Object
 
 ```typescript
@@ -219,6 +235,10 @@ const result = await llm.structured(
       transformToolOutput: (output, execution) => {
         return { ...output, source: execution.name };
       },
+      // Optional: transform tool arguments before the tool is called
+      transformToolArguments: (args, call) => args,
+      // Optional: custom error message when an unknown tool is called
+      unknownToolError: (toolName) => `Tool "${toolName}" is not available.`,
     },
   }
 );
@@ -233,6 +253,7 @@ Run examples with: `bun run dev <example-name>`
 Available examples:
 - `streaming` - Real LLM streaming + snapshot self-check ([streaming.ts](examples/streaming.ts))
 - `streaming-with-tools` - Real text streaming with MCP tools + self-check ([streaming-with-tools.ts](examples/streaming-with-tools.ts))
+- `abort-signal` - Start a generation then cancel quickly with `AbortSignal` ([abort-signal.ts](examples/abort-signal.ts))
 - `simple` - Basic structured output with streaming ([simple.ts](examples/simple.ts))
 - `sentiment-analysis` - Enum validation, strict mode ([sentiment-analysis.ts](examples/sentiment-analysis.ts))
 - `data-extraction` - Complex nested schemas, self-healing ([data-extraction.ts](examples/data-extraction.ts))
@@ -243,6 +264,7 @@ Pass arguments after the example name:
 ```bash
 bun run dev streaming
 bun run dev streaming-with-tools
+bun run dev abort-signal 120 "JSON cancellation demo"
 bun run dev simple "Bun.js runtime"
 bun run dev sentiment-analysis "I love this product."
 bun run dev multi-step-reasoning "Why is the sky blue?"