chore: import upstream snapshot with attribution

packages/llmz/examples/01_chat_basic/README.md

@@ -0,0 +1,3 @@
+## 🎥 Demo
+
+![Demo](./demo.svg)

packages/llmz/examples/01_chat_basic/index.ts

@@ -0,0 +1,51 @@
+/**
+ * Example 01: Basic Chat
+ *
+ * This example demonstrates the most basic usage of LLMz in chat mode.
+ * It shows how to:
+ * - Set up a Botpress client for LLM interactions
+ * - Create a simple CLI chat interface
+ * - Execute LLMz with basic instructions
+ * - Handle conversation flow with automatic user interaction
+ *
+ * Key concepts:
+ * - Chat mode execution with user interaction
+ * - Basic instruction prompting
+ * - Conversation history management
+ */
+
+import { CLIChat } from '../utils/cli-chat'
+import { Client } from '@botpress/client'
+import { execute } from 'llmz'
+
+// Initialize the Botpress Client for LLM interactions
+// This client handles authentication and communication with language models
+const client = new Client({
+  botId: process.env.BOTPRESS_BOT_ID!, // Your Botpress bot identifier
+  token: process.env.BOTPRESS_TOKEN!, // Authentication token for API access
+})
+
+// Create a CLI chat interface that provides:
+// - Command-line user input/output
+// - Conversation history management
+// - Message formatting and display
+const chat = new CLIChat()
+
+// Main conversation loop
+// chat.iterate() returns true until an exit is detected or iterations exceeded
+// chat.iterate captures user input and manages conversation state
+while (await chat.iterate()) {
+  // Execute LLMz with the user's message and conversation context
+  await execute({
+    // Instructions define the agent's role and behavior
+    instructions:
+      "You are a helpful assistant. Greet the user and suggest topics for discussion using buttons. Don't let users type themselves, suggest topics instead.",
+
+    // Pass the chat interface to enable interactive conversation
+    // This automatically adds the user's message to the execution context
+    chat,
+
+    // The Botpress client for LLM communication
+    client,
+  })
+}