Implement WorkflowDrivenAgent documentation and remove outdated examples

- Added detailed documentation for the new `WorkflowDrivenAgent`, explaining its features, usage, and integration with existing systems.
- Included a code example demonstrating the creation and execution of a workflow using the `WorkflowDrivenAgent`.
- Removed outdated example files and tests related to the `WorkflowDrivenAgent` to streamline the codebase and improve clarity.

Author: anthonydevs17

README.md

@@ -517,6 +517,67 @@ For more details on how to utilize observability features in KaibanJS, please vi
 
   </details>
 
+  <details style="margin-bottom:10px;">
+  <summary><b style="color:black;">WorkflowDrivenAgent</b></summary>
+
+<p style="margin-top:10px;">
+The `WorkflowDrivenAgent` is a specialized agent that executes workflows instead of using LLM-based reasoning. This agent maintains workflow state and can handle suspension and resumption operations for long-running workflows, providing a deterministic approach to task execution.
+
+In this example, a `WorkflowDrivenAgent` is created to execute a workflow that processes data through defined steps, allowing for complex multi-step operations without LLM calls.
+
+</p>
+
+```js
+import { Agent } from 'kaibanjs';
+import { createStep, createWorkflow } from '@kaibanjs/workflow';
+import { z } from 'zod';
+
+// Create workflow steps
+const processStep = createStep({
+  id: 'process',
+  inputSchema: z.object({ data: z.string() }),
+  outputSchema: z.object({ result: z.string() }),
+  execute: async ({ inputData }) => {
+    const { data } = inputData as { data: string };
+    return { result: data.toUpperCase() };
+  },
+});
+
+// Create the workflow
+const workflow = createWorkflow({
+  id: 'example-workflow',
+  inputSchema: z.object({ data: z.string() }),
+  outputSchema: z.object({ result: z.string() }),
+});
+
+workflow.then(processStep);
+workflow.commit();
+
+// Create the agent using the Agent wrapper
+const agent = new Agent({
+  type: 'WorkflowDrivenAgent',
+  name: 'Workflow Agent',
+  workflow: workflow,
+});
+
+// Use the agent in a team
+const team = new Team({
+  name: 'Workflow Team',
+  agents: [agent],
+  tasks: [
+    new Task({
+      description: 'Process the input data using workflow',
+      expectedOutput: 'Processed data result',
+      agent: agent,
+    }),
+  ],
+});
+```
+
+_The `WorkflowDrivenAgent` integrates seamlessly with the existing team system, supports workflows with suspension for manual intervention, and provides detailed logging for workflow events. For more information, visit the [WorkflowDrivenAgent documentation](https://github.com/kaiban-ai/KaibanJS/tree/main/packages/workflow/src/examples/kaibanjs-integration-readme.md)._
+
+  </details>
+
 ## Documentation
 
 - [Official Documentation](https://docs.kaibanjs.com/category/get-started)

packages/workflow/src/examples/README.md …/examples/kaibanjs-integration-readme.mdpackages/workflow/src/examples/README.md renamed to packages/workflow/src/examples/kaibanjs-integration-readme.md packages/workflow/src/examples/README.md renamed to packages/workflow/src/examples/kaibanjs-integration-readme.md

@@ -1,8 +1,90 @@
-# React + Vite
+# KaibanJS React Playground
 
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+This playground demonstrates various KaibanJS features including workflow-driven agents, LLM integrations, and team collaboration patterns.
 
-Currently, two official plugins are available:
+## Features
 
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+- **Workflow-Driven Agents**: Demonstrates structured workflow execution
+- **Multi-SDK Integration**: Combines LangChain and Vercel AI SDK
+- **Team Collaboration**: Shows how different agent types work together
+- **Storybook Integration**: Interactive examples and documentation
+
+## Environment Variables
+
+Create a `.env` file in the root directory with the following variables:
+
+```bash
+# OpenAI API Key for LangChain and AI SDK
+VITE_OPENAI_API_KEY=your_openai_api_key_here
+
+# Anthropic API Key for ReactChampionAgent
+VITE_ANTHROPIC_API_KEY=your_anthropic_api_key_here
+
+# Tavily API Key for web search
+VITE_TAVILY_API_KEY=your_tavily_api_key_here
+```
+
+## Getting Started
+
+1. **Build the workflow package first** (required for local development):
+
+   ```bash
+   cd ../../packages/workflow
+   npm install
+   npm run build
+   cd ../../playground/react
+   ```
+
+   > **Important**: The workflow package must be built before running the playground because it uses a local file reference (`file:../../packages/workflow`) in its dependencies. This ensures the latest workflow code is available to the playground.
+
+2. Install dependencies:
+
+   ```bash
+   npm install
+   ```
+
+3. Set up environment variables (see above)
+
+4. Start the development server:
+
+   ```bash
+   npm run dev
+   ```
+
+5. Start Storybook for interactive examples:
+   ```bash
+   npm run storybook
+   ```
+
+## Available Stories
+
+- **Basic Workflow**: Simple mathematical workflow
+- **Complex Workflow**: Advanced patterns with conditional logic
+- **Suspension Workflow**: Workflow with pause/resume capabilities
+- **Mixed Team**: WorkflowDrivenAgent + ReactChampionAgent collaboration
+- **LangChain + AI SDK Workflow**: Multi-SDK integration example
+- **LangChain Only Workflow**: Pure LangChain implementation
+- **AI SDK Only Workflow**: Pure Vercel AI SDK implementation with web search tool
+
+## Troubleshooting
+
+### Common Issues
+
+1. **"Module not found" errors**: Make sure you've built the workflow package first (step 1 above)
+
+2. **"crypto.randomUUID is not a function"**: This is a browser compatibility issue. The workflow package includes a polyfill, but you may need to clear your browser cache or restart the dev server.
+
+3. **API Key errors**: Ensure all required environment variables are set in your `.env` file
+
+4. **Tool calling errors**: Make sure you have the latest version of the AI SDK packages installed
+
+### Rebuilding After Changes
+
+If you make changes to the workflow package, you'll need to rebuild it:
+
+```bash
+cd ../../packages/workflow
+npm run build
+cd ../../playground/react
+# Restart your dev server or Storybook
+```